v1

latestOpenAPI 3.1.02026-07-2611077199.5 KB

Query a Gemini video generation job by jobId. If no success or failure result is available within 15 minutes, the job is marked as failed with a timeout message.

get/gemini/video/fetch

Query parameters

jobIdstring required

jobId returned by the generation endpoint

Response

Query successful

status'RUNNING' | 'SUCCESS' | 'FAILED' required

Task status

messagestring required

Task message

jobIdstring required

Job ID

Example response

{
  "status": "SUCCESS",
  "message": "success",
  "jobId": "0ccf0606-3f32-4090-85bd-1786e4593be5",
  "data": {
    "jobId": "0ccf0606-3f32-4090-85bd-1786e4593be5",
    "model": "omni-flash",
    "prompt": "A cinematic shot of a futuristic city at sunset",
    "aspect_ratio": "16:9",
    "reference_images": [
      "https://cdn.ttapi.io/example/reference-image.png"
    ],
    "video_url": "https://cdn.ttapi.io/other/2026-06-05/example.mp4",
    "quota": "1",
    "hookUrl": "https://example.com/callback"
  }
}