Veo Video Generation

Gemini Veo video generation API supports text-to-video, image-to-video, frame interpolation, and reference images.

Supported Models

Model	Version	Speed	Audio	Image-to-Video	Frame Interpolation	Reference Images
veo-2.0-generate-001	2.0	Standard	❌	✅ Single	❌	❌
veo-3.0-generate-001	3.0	Standard	✅	✅ Single	❌	❌
veo-3.0-fast-generate-001	3.0	Fast	✅	✅ Single	❌	❌
veo-3.1-generate-preview	3.1	Standard	✅	✅ Single	✅ Dual	✅ Up to 3
veo-3.1-fast-generate-preview	3.1	Fast	✅	✅ Single	✅ Dual	✅ Up to 3

Usage Modes

Mode	images Count	referenceImages	Duration	Model Requirement
Text-to-Video	0	Optional 0-3*	4/6/8s	All versions
Image-to-Video	1	Optional 0-3*	4/6/8s	All versions
Frame Interpolation	2	Not supported	8s only	Veo 3.1 only

Important Limitation: Frame interpolation (2 images) and reference images (referenceImages) are mutually exclusive and cannot be used together. Reference images feature is only supported by Veo 3.1.

Create Video Generation Task

Create a video generation task, returns task_id for subsequent queries.

Create Video Generation Task

post

Create video generation task with text-to-video, image-to-video, or frame interpolation modes. Returns task_id for status queries.

Authorizations

BearerAuth

AuthorizationstringRequired

Authenticate using Bearer Token. Get API Key at https://viralapi.ai/api-key

Body

application/json

modelstring · enumRequired

Model name. Veo 2.0 supports basic features; Veo 3.0+ adds audio output; Veo 3.1 adds frame interpolation and reference images

Possible values:

promptstring · max: 4096Required

Text description for video generation (max 1024 tokens)

imagesstring[] · min: 1 · max: 2Optional

Image array. 1 image for image-to-video (as first frame); 2 images for frame interpolation (first and last frames, Veo 3.1 only)

Responses

200

Task created successfully

application/json

idstringOptional

Task ID

task_idstringOptional

Task ID (same as id)

objectstring · enumOptional

Object type

Possible values:

created_atintegerOptional

Creation timestamp (Unix seconds)

modelstringOptional

Model name used

statusstring · enumOptional

Task status

Possible values:

400

Invalid request parameters

application/json

401

Authentication failed

application/json

402

Insufficient account balance

application/json

403

Insufficient permissions

application/json

500

Internal server error

application/json

502

Gateway error

application/json

post

/v1/videos

HTTPcURLJavaScriptPython

POST /v1/videos HTTP/1.1
Host: viralapi.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 185

{
  "model": "veo-3.0-generate-001",
  "prompt": "A cute orange cat chasing butterflies in a sunny garden, slow motion, cinematic quality",
  "metadata": {
    "aspectRatio": "16:9",
    "durationSeconds": 6
  }
}

{
  "id": "dmlkZW9fdGFzay0xMjM0NTY3ODkw",
  "task_id": "dmlkZW9fdGFzay0xMjM0NTY3ODkw",
  "object": "video.generation",
  "created_at": 1704672000,
  "model": "veo-3.0-generate-001",
  "status": "queued"
}

Query Video Task Status

Query the status and results of a video generation task. Recommended polling interval: 5 seconds.

Query Video Task Status

get

Query video generation task status and results. Returns video download URL when task completes.

Authorizations

BearerAuth

AuthorizationstringRequired

Authenticate using Bearer Token. Get API Key at https://viralapi.ai/api-key

Path parameters

task_idstringRequired

Task ID (returned from create task endpoint)

Example: dmlkZW9fdGFzay0xMjM0NTY3ODkw

Responses

200

Query successful

application/json

task_idstringOptional

Task ID

statusstring · enumOptional

Task status: queued (queued), in_progress (processing), success (completed), failure (failed)

Possible values:

progressstringOptional

Progress percentage

urlstring · uriOptional

Video download URL (returned when status is success)

fail_reasonstringOptional

Failure reason (returned when status is failure)

401

Authentication failed

application/json

404

Task not found

application/json

500

Internal server error

application/json

get

/v1/videos/{task_id}

HTTPcURLJavaScriptPython

GET /v1/videos/{task_id} HTTP/1.1
Host: viralapi.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "task_id": "dmlkZW9fdGFzay0xMjM0NTY3ODkw",
  "status": "in_progress",
  "progress": "50%"
}