API reference

Base URL

https://reeloop.ai/api/v1

All endpoints are JSON. Authenticate every request with a Bearer token (see Authentication).

Generate a video

POST /api/v1/generate - starts an async render and returns a job id.

curl -X POST https://reeloop.ai/api/v1/generate \
  -H "Authorization: Bearer fl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "5 facts about the ocean nobody knows",
    "style": "documentary",
    "voice": "charlotte",
    "language": "en",
    "durationSeconds": 30
  }'

{ "jobId": "7c9e2a1d-…", "status": "processing" }

Check render status

GET /api/v1/jobs/{jobId} - poll until status is completed.

{
  "jobId": "7c9e2a1d-…",
  "status": "completed",
  "videoUrl": "https://…/media/….mp4",
  "durationSeconds": 30
}

Generation typically takes 2-4 minutes. Prefer webhooks over polling for production use.