8s previewGemini Video
Veo-class video generation with strong prompt adherence and visual stability.
8s previewPrompt to video, in context
a paper plane gliding above a city at golden hour
- Resolution
- 1080p
- Duration
- 8s
Golden-hour flight
A paper plane crosses a layered skyline with stable motion and soft volumetric light.
What you can build with Gemini Video
Prompt driven generation
Submit a concise prompt and get production-ready video output through one TTAPI job.
Core controls only
Keep integration simple with prompt, model, output settings, and callback handling.
Async result flow
Use polling or webhook callbacks so long-running generations do not block your UI.
Ready for product UI
Return Gemini Video results that can be displayed, stored, or passed into downstream workflows.
Per-action, in quota
Usage is metered in quota by model, action, and output settings.
Headers and submit parameters
Use the endpoint below with your TTAPI key and the request fields shown.
/gemini/video/generationsSubmit a Gemini Video generation task.
Official reference/gemini/video/extendExtend a completed Gemini video task.
Official reference/gemini/video/fetchRetrieve a Gemini Video task result.
Official referenceHeaders
TT-API-KEYstringrequiredYour TTAPI API key.
Content-TypestringrequiredUse application/json.
Body
promptstringrequiredScene and motion prompt.
modelstringrequiredVeo or Omni model identifier.
aspect_ratioenumrequired16:9 or 9:16.
durationstringoptionalSupported clip duration.
resolutionenumoptionalRequested output resolution.
generation_typeenumoptionalframe or reference generation workflow.
reference_imagesstring[]conditionalReference images for frame or reference generation.
reference_videosstring[]optionalReference videos for supported workflows.
hookUrlstringoptionalCallback URL for task completion.
From key to first result
Copy the resolved endpoint, authentication headers, and request body for this model.
curl --request POST \
--url https://api.ttapi.io/gemini/video/generations \
--header 'TT-API-KEY: $TTAPI_KEY' \
--header 'Content-Type: application/json' \
--data '{"prompt":"a paper plane above a city","model":"veo-3.1-quality","aspect_ratio":"16:9","resolution":"1080p","duration":"8","hookUrl":"https://example.com/webhooks/gemini-video"}'