Generate Video

string

required

Model ID (required — no default)

object

required

Model-specific parameters — all params supported. Must include prompt.

curl -X POST https://api.usenaive.ai/v1/video/generate \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fal-ai/kling-video/v3/pro/text-to-video",
    "input": {
      "prompt": "A golden retriever running on a beach at sunset",
      "duration": "5",
      "aspect_ratio": "16:9"
    }
  }'

{
  "id": "job-uuid",
  "job_id": "job-uuid",
  "status": "queued",
  "type": "video_generation",
  "model": "fal-ai/kling-video/v3/pro/text-to-video",
  "estimated_seconds": 60,
  "estimated_credits": 22.4,
  "hint": "Poll GET /v1/jobs/job-uuid or GET /v1/video/job-uuid. Credits charged on completion only."
}

Use id, not job_id. The job identifier is returned as id on both submit and status, so the same field works for the whole lifecycle. job_id is a deprecated alias kept for backward compatibility; prefer id.

Cost: Dynamic — model/duration-dependent. Preview with GET /v1/video/pricing?model=<id>&duration=<s>. Based on model costs at $0.05/credit. Charged on completion only.

Completed Result

When polling via GET /v1/jobs/:id or GET /v1/video/:jobId:

{
  "id": "job-uuid",
  "type": "video_generation",
  "status": "completed",
  "progress": 100,
  "model": "fal-ai/kling-video/v3/pro/text-to-video",
  "media": [
    { "url": "https://fal.media/files/.../video.mp4", "type": "video" }
  ],
  "result": {
    "video": {
      "url": "https://fal.media/files/.../video.mp4",
      "content_type": "video/mp4",
      "file_size": 4521987
    }
  },
  "credits_used": 22.4,
  "created_at": "2026-05-02T10:30:00Z",
  "completed_at": "2026-05-02T10:31:02Z"
}

Reading the output URL. Use the flat media array — media[0].url is stable across image and video jobs and every model. The raw provider payload is still under result (result.video.url), but its nesting varies by model; media[] does not.

curl -X POST https://api.usenaive.ai/v1/video/generate \ -H "Authorization: Bearer nv_sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "model": "fal-ai/kling-video/v3/pro/text-to-video", "input": { "prompt": "A golden retriever running on a beach at sunset", "duration": "5", "aspect_ratio": "16:9" } }'

{ "id": "job-uuid", "job_id": "job-uuid", "status": "queued", "type": "video_generation", "model": "fal-ai/kling-video/v3/pro/text-to-video", "estimated_seconds": 60, "estimated_credits": 22.4, "hint": "Poll GET /v1/jobs/job-uuid or GET /v1/video/job-uuid. Credits charged on completion only." }

​Completed Result

Completed Result