naralens/Docs

Quickstart

Reframe your first video to 9:16 in three calls.

Step 1: Get Your API Key

Sign up at naralens.com/auth/signup and create an API key from your dashboard. Send it as a Bearer token on every request.

Step 2: Submit a Video

POST a public video URL. You get back a job_id immediately. The pipeline runs asynchronously.

Bash
curl -X POST https://naralens.com/api/v2/reframe \
  -H "Authorization: Bearer $NARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/video.mp4"}'

# Response: { "job_id": "9f1c...", "status": "processing", "step": "ingesting" }

Step 3: Poll the Job

Poll the job every few seconds. status is one of processing, completed, or failed.

Bash
curl https://naralens.com/api/v2/reframe/$JOB_ID \
  -H "Authorization: Bearer $NARA_API_KEY"

# When done:
# {
#   "status": "completed",
#   "video_id": "a1b2c3d4-...",
#   "download_url": "/api/v2/download/a1b2c3d4-...?suffix=_reframe"
# }

Step 4: Download the Clip

Fetch the 9:16 output from the returned download_url (same API key). The file streams through the API.

Bash
curl -L -o clip.mp4 \
  "https://naralens.com/api/v2/download/$VIDEO_ID?suffix=_reframe" \
  -H "Authorization: Bearer $NARA_API_KEY"

Billing

Charged once per job by source video duration: 1 credit = 1 second (rounded down). A 30-second video costs 30 credits. Re-polling and re-downloading are free.

Next Steps