Skip to main content
GET
/
gemini
/
video
/
fetch
cURL
curl --request GET \
  --url https://api.ttapi.org/gemini/video/fetch \
  --header 'TT-API-KEY: <api-key>'
{
  "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"
  }
}

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Query Parameters

jobId
string
required

jobId returned by the generation endpoint

Response

Query successful

status
enum<string>
required

Task status

Available options:
RUNNING,
SUCCESS,
FAILED
Example:

"SUCCESS"

message
string
required

Task message

Example:

"success"

jobId
string
required

Job ID

Example:

"0ccf0606-3f32-4090-85bd-1786e4593be5"

data
object
required

Video task result

Last modified on June 5, 2026