Skip to main content
POST
/
gemini
/
video
/
generations
cURL
curl --request POST \
  --url https://api.ttapi.org/gemini/video/generations \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "A cinematic shot of a futuristic city at sunset",
  "model": "omni-flash",
  "aspect_ratio": "16:9",
  "reference_images": [
    "https://cdn.ttapi.io/example/reference-image.png",
    "https://cdn.ttapi.io/example/reference-video.mp4"
  ],
  "hookUrl": "https://example.com/callback"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "0ccf0606-3f32-4090-85bd-1786e4593be5"
  }
}
Video generation is asynchronous. After a successful submission, use the returned jobId with the Video Fetch API.

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
prompt
string
required

Video prompt

Example:

"A cinematic shot of a futuristic city at sunset"

​
model
enum<string>
default:omni-flash
required

Video model. Currently only omni-flash is supported.

Available options:
omni-flash
​
aspect_ratio
enum<string>
required

Video aspect ratio

Available options:
16:9,
9:16
Example:

"16:9"

​
reference_images
string[]

Reference media URLs. Image URLs and video URLs are supported; blank strings are ignored.

Example:
[
  "https://cdn.ttapi.io/example/reference-image.png",
  "https://cdn.ttapi.io/example/reference-video.mp4"
]
​
hookUrl
string

Callback URL for completion or failure notifications

Example:

"https://example.com/callback"

Response

Submitted successfully

​
status
string
required

Task status

Example:

"SUCCESS"

​
message
string
required

Task message

Example:

"success"

​
data
object
required
Last modified on June 5, 2026