Skip to main content
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gemini_omni",
    "prompt": "A cinematic shot of a cat running through neon rain",
    "aspect_ratio": "16:9",
    "duration": 6,
    "resolution": "720P"
  }'

{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini_omni",
  "status": "queued",
  "created_at": 1779247407
}

Documentation Index

Fetch the complete documentation index at: https://docs.toapis.com/llms.txt

Use this file to discover all available pages before exploring further.

  • Public model name: gemini_omni
  • Async task mode. The API returns a task ID that you can poll with the video task status endpoint.
  • aspect_ratio supports 16:9 and 9:16.
  • duration supports 6 seconds and 10 seconds.
  • resolution is currently fixed to 720P.

​
Authorizations

​
Authorization
string
required
All endpoints require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
default:"gemini_omni"
required
Video generation model name. Use gemini_omni.
​
prompt
string
required
Text prompt for the generated video.
​
aspect_ratio
string
default:"16:9"
Video aspect ratio.Options:
  • 16:9 - landscape
  • 9:16 - portrait
​
duration
integer
default:6
Video duration in seconds.Options: 6, 10.
​
resolution
string
default:"720P"
Video resolution. Currently only 720P is supported.

​
Response

​
id
string
Unique task ID for polling task status.
​
object
string
Object type, always generation.task.
​
model
string
Model name used for the request.
​
status
string
Task status: queued, in_progress, completed, or failed.
​
created_at
integer
Task creation timestamp.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gemini_omni",
    "prompt": "A cinematic shot of a cat running through neon rain",
    "aspect_ratio": "16:9",
    "duration": 6,
    "resolution": "720P"
  }'

{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini_omni",
  "status": "queued",
  "created_at": 1779247407
}

​
Query Task

The generation endpoint returns a task ID. Use the common video task status endpoint to fetch status and results: 
curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"