Get Job - Naïve

string

required

Job UUID

curl https://api.usenaive.ai/v1/jobs/job-uuid \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "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
    }
  },
  "error": null,
  "credits_used": 50,
  "provider_request_id": "req-123",
  "created_at": "2026-05-02T10:30:00Z",
  "started_at": "2026-05-02T10:30:01Z",
  "completed_at": "2026-05-02T10:31:02Z",
  "metadata": { "estimated_seconds": 60 }
}

Result schema

For single-output media jobs (image_generation, video_generation) the response carries two views of the output:

Field	Shape	Use
`media`	`[{ "url": string, "type": "image" \| "video" }]`	Preferred. Flat, model-independent list. `media[0].url` is stable across image/video jobs and every model. Present (possibly `[]` until completion) for these jobs.
`result`	provider-native object	Raw provider payload with all fields (`result.images[].url`, `result.video.url`). Nesting varies by model; use `media` unless you need a provider-specific field.

Other job types omit media. clip_generation in particular returns several URLs per clip (download_url, direct_url, preview_url) — read those from result.clips[] directly rather than flattening to a single URL.

{ "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 } }, "error": null, "credits_used": 50, "provider_request_id": "req-123", "created_at": "2026-05-02T10:30:00Z", "started_at": "2026-05-02T10:30:01Z", "completed_at": "2026-05-02T10:31:02Z", "metadata": { "estimated_seconds": 60 } }

​Result schema

Result schema