Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
model
string
required
Model ID (required — no default)
​
input
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"
    }
  }'

{
  "job_id": "job-uuid",
  "status": "queued",
  "type": "video_generation",
  "model": "fal-ai/kling-video/v3/pro/text-to-video",
  "estimated_seconds": 60,
  "estimated_credits": 5,
  "hint": "Poll GET /v1/jobs/job-uuid or GET /v1/video/job-uuid. Credits charged on completion only."
}
Cost: Dynamic — model/duration-dependent. Preview with GET /v1/video/pricing?model=<id>&duration=<s>. Based on model costs at $0.50/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",
  "result": {
    "video": {
      "url": "https://fal.media/files/.../video.mp4",
      "content_type": "video/mp4",
      "file_size": 4521987
    }
  },
  "credits_used": 5,
  "created_at": "2026-05-02T10:30:00Z",
  "completed_at": "2026-05-02T10:31:02Z"
}