Veo 3.1 Fast API Veo 3.1 API - AI Video Generation APIs

Veo 3.1 Fast API Veo 3.1 API, developers can access Veo 3.1 for generating videos that accurately depict motion, lighting, and real-world physics. The API leverages Google's DeepMind research to produce videos with remarkable realism, suitable for professional video production and creative applications.

Get API Key

View in Playground

Models Version

LIMITED TIME OFFER

Get $5 Free Credit on First Payment

No strings attached — add funds and get $5 bonus instantly

Claim Your $5 →

Veo v3.1 Fast Text to Video API Documentation

https://gateway.pixazo.ai/veo31f/v1

Authentication

All requests require an API key passed via header.

Header	Type	Required	Description
Ocp-Apim-Subscription-Key	string	Yes	Your API subscription key

Veo 3.1 Fast Video Generation Request - Veo 3.1 Fast API

Request Code

POST https://gateway.pixazo.ai/veo31f/v1/veo-3.1-fast/generate HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "prompt": "A snow-covered tree gradually transforms as winter melts away, snow dripping from branches as green leaves emerge and colorful flowers bloom around the base, transitioning from a cold white landscape to a vibrant lush green meadow full of life",
  "image": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
  "last_frame": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "negative_prompt": "blurry, low quality, distorted, artifacts, text, watermark",
  "generate_audio": true,
  "seed": 42
}

import requests

url = "https://gateway.pixazo.ai/veo31f/v1/veo-3.1-fast/generate"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "prompt": "A snow-covered tree gradually transforms as winter melts away, snow dripping from branches as green leaves emerge and colorful flowers bloom around the base, transitioning from a cold white landscape to a vibrant lush green meadow full of life",
    "image": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
    "last_frame": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "negative_prompt": "blurry, low quality, distorted, artifacts, text, watermark",
    "generate_audio": True,
    "seed": 42
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const url = 'https://gateway.pixazo.ai/veo31f/v1/veo-3.1-fast/generate';
const headers = {
  'Content-Type': 'application/json',
  'Cache-Control': 'no-cache',
  'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
};
const data = {
  prompt: 'A snow-covered tree gradually transforms as winter melts away, snow dripping from branches as green leaves emerge and colorful flowers bloom around the base, transitioning from a cold white landscape to a vibrant lush green meadow full of life',
  image: 'https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png',
  last_frame: 'https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png',
  duration: 8,
  aspect_ratio: '16:9',
  resolution: '1080p',
  negative_prompt: 'blurry, low quality, distorted, artifacts, text, watermark',
  generate_audio: true,
  seed: 42
};

fetch(url, {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

curl -X POST "https://gateway.pixazo.ai/veo31f/v1/veo-3.1-fast/generate" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "prompt": "A snow-covered tree gradually transforms as winter melts away, snow dripping from branches as green leaves emerge and colorful flowers bloom around the base, transitioning from a cold white landscape to a vibrant lush green meadow full of life",
    "image": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
    "last_frame": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "negative_prompt": "blurry, low quality, distorted, artifacts, text, watermark",
    "generate_audio": true,
    "seed": 42
  }'

Output

{
  "request_id": "veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Try Now

Webhook (Optional)

Add the X-Webhook-URL header to your submit request to receive a POST callback when the job completes — no polling required.

Webhook Headers

Header	Required	Default	Description
`X-Webhook-URL`	Yes (to enable)	—	HTTPS endpoint on your server that will receive the `POST` callback. Must respond `2xx` within a few seconds (process async if needed).
`X-Webhook-Mode`	No	`terminal`	`terminal` — fires once at the final status (`COMPLETED`/`FAILED`/`ERROR`). `sync` — fires on every poll cycle plus the terminal event, and caps the queue’s polling delay at 15s for tighter progress updates.

Example: enable webhook

X-Webhook-URL: https://your-server.com/webhook/callback
X-Webhook-Mode: terminal

Callback Payload

Your endpoint receives a POST application/json with the same shape as the GET /v2/requests/status/{request_id} response. Example terminal callback (mode terminal):

{
  "request_id": "veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "veo-3-1-fast",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.mp4"
    ],
    "media_type": "video/mp4"
  },
  "created_at": "2026-05-22T13:17:32.110Z",
  "updated_at": "2026-05-22 13:19:23",
  "completed_at": "2026-05-22 13:19:23"
}

Failure callback shape

{
  "request_id": "veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "veo-3-1-fast",
  "error": "Description of the error",
  "output": null,
  "created_at": "...",
  "updated_at": "...",
  "completed_at": "..."
}

Delivery semantics

terminal mode (default) — exactly one POST when the request reaches a terminal status. No callback during PROCESSING.
sync mode — POST on every status poll (with delay capped at ~15s) plus a final POST at terminal status. Use when you want progress updates.
Idempotency — use request_id as your idempotency key. Network retries can deliver the same callback more than once; your handler must tolerate duplicates.
Response — respond 200 OK within a few seconds. The queue does not block on slow handlers, but persistent failures may stop further deliveries.
HTTPS required — plain http:// URLs are rejected.

Request Parameters - Veo 3.1 Fast Video Generation

Parameter	Required	Type	Default	Allowed values / range	Description
`prompt`	Yes	string	—	—	Text prompt describing the desired video content, motion, mood, or style.
`image`	No	string	—	HTTP(S) URL	Reference image to guide generation (used as the starting frame).
`last_frame`	No	string	—	HTTP(S) URL	Image to use as the last frame, enabling start-to-end transitions. Requires `image`.
`duration`	No	integer	8	`4`, `6`, `8` (seconds)	Length of the generated video.
`aspect_ratio`	No	string	`"16:9"`	`"16:9"`, `"9:16"`	Output aspect ratio.
`resolution`	No	string	`"720p"`	`"720p"`, `"1080p"`	Output resolution. 1080p requires `duration` = 8.
`negative_prompt`	No	string	—	—	Elements to avoid (e.g. "blurry, low quality, distorted, artifacts, text, watermark").
`generate_audio`	No	boolean	`true`	`true`, `false`	Generate synchronized audio alongside the video.
`seed`	No	integer	—	—	Random seed for reproducible generation.

Output: MP4, 24 fps, with an embedded Google SynthID watermark. 1080p output requires duration = 8.

Example Request

{
  "prompt": "A snow-covered tree gradually transforms as winter melts away, snow dripping from branches as green leaves emerge and colorful flowers bloom around the base, transitioning from a cold white landscape to a vibrant lush green meadow full of life",
  "image": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f1.png",
  "last_frame": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/f2.png",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "negative_prompt": "blurry, low quality, distorted, artifacts, text, watermark",
  "generate_audio": true,
  "seed": 42
}

Response

{
  "request_id": "veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

Header	Value
Content-Type	application/json
Cache-Control	no-cache
Ocp-Apim-Subscription-Key	YOUR_SUBSCRIPTION_KEY

Response Handling

Common status codes.

Code	Meaning
202	Accepted — Request queued
400	Bad Request
401	Unauthorized
402	Insufficient Balance
403	Forbidden
429	Too Many Requests
500	Internal Server Error

Error Responses

Queue system errors and model validation errors.

Queue System Errors

// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance. Required: $0.01"
}

// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'veo-3-1-fast' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "veo-3-1-fast_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "veo-3-1-fast",
  "error": "Description of the error",
  "output": null
}

Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY

cURL Example

curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/veo-3-1-fast_019d42ce-ae71-7999-24c9-5d76447ecafb4"

Response (Completed)

{
  "request_id": "veo-3-1-fast_019d42ce-ae71-7999-24c9-5d76447ecafb4",
  "status": "COMPLETED",
  "model_id": "veo-3-1-fast",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/veo-3-1-fast_019d42ce-ae71-7999-24c9-5d76447ecafb4/output.mp4"
    ],
    "media_type": "video/mp4"
  },
  "created_at": "2026-04-01T07:32:03.749Z",
  "updated_at": "2026-04-01T07:32:20.000Z",
  "completed_at": "2026-04-01T07:32:20.000Z"
}

Response Fields

Field	Type	Description
request_id	string	Unique request identifier
status	string	QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR
model_id	string	Model that processed the request
error	string\|null	Error message if failed
output.media_url	array	URLs to generated media (R2 CDN)
output.media_type	string	MIME type (video/mp4)
created_at	string	When request was created
completed_at	string\|null	When request completed
polling_url	string	Status URL (initial response only)

Status Values

Status	Description
QUEUED	Request accepted, waiting to be processed
PROCESSING	Being processed by the model
COMPLETED	Done — output contains the result
FAILED	Failed — check error field
ERROR	System error — not charged

Status Flow

QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR

Typical Workflow

Send a generate request to the API endpoint
Save the request_id from the response
Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
When status is "COMPLETED", download from output.media_url

Tip: Use X-Webhook-URL header to get a callback instead of polling.

Veo v3.1 Fast Text to Video API Pricing

Resolution	Duration	Price (USD)
with_audio	1s	$0.15
without_audio	1s	$0.1

Veo v3.1 Fast Reference to Video (Reference Images to Video) API Documentation

https://gateway.pixazo.ai/veo-3-1-fast-reference-to-video/v1

Authentication

All requests require an API key passed via header.

Header	Type	Required	Description
Ocp-Apim-Subscription-Key	string	Yes	Your API subscription key

Veo 3.1 Fast Reference to Video generate request

Request Code

POST https://gateway.pixazo.ai/veo-3-1-fast-reference-to-video/v1/veo-3-1-fast-reference-to-video-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_API_KEY

{
  "prompt": "A chimpanzee wearing overalls frolics in the grassy field, gently playing with butterflies. In the background, a circus tent and carousel beckon.",
  "image_urls": [
    "https://example.com/example_inputs/veo31-r2v-input-1.png",
    "https://example.com/example_inputs/veo31-r2v-input-2.png",
    "https://example.com/example_inputs/veo31-r2v-input-3.png"
  ],
  "aspect_ratio": "16:9",
  "duration": "8s",
  "resolution": "720p",
  "generate_audio": true,
  "safety_tolerance": "4"
}

import requests

url = "https://gateway.pixazo.ai/veo-3-1-fast-reference-to-video/v1/veo-3-1-fast-reference-to-video-request"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
data = {
    "prompt": "A chimpanzee wearing overalls frolics in the grassy field, gently playing with butterflies. In the background, a circus tent and carousel beckon.",
    "image_urls": [
        "https://example.com/example_inputs/veo31-r2v-input-1.png",
        "https://example.com/example_inputs/veo31-r2v-input-2.png",
        "https://example.com/example_inputs/veo31-r2v-input-3.png"
    ],
    "aspect_ratio": "16:9",
    "duration": "8s",
    "resolution": "720p",
    "generate_audio": true,
    "safety_tolerance": "4"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const url = "https://gateway.pixazo.ai/veo-3-1-fast-reference-to-video/v1/veo-3-1-fast-reference-to-video-request";
const headers = {
  "Content-Type": "application/json",
  "Cache-Control": "no-cache",
  "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
};
const data = {
  "prompt": "A chimpanzee wearing overalls frolics in the grassy field, gently playing with butterflies. In the background, a circus tent and carousel beckon.",
  "image_urls": [
    "https://example.com/example_inputs/veo31-r2v-input-1.png",
    "https://example.com/example_inputs/veo31-r2v-input-2.png",
    "https://example.com/example_inputs/veo31-r2v-input-3.png"
  ],
  "aspect_ratio": "16:9",
  "duration": "8s",
  "resolution": "720p",
  "generate_audio": true,
  "safety_tolerance": "4"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data));

curl -X POST "https://gateway.pixazo.ai/veo-3-1-fast-reference-to-video/v1/veo-3-1-fast-reference-to-video-request" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  --data-raw '{
    "prompt": "A chimpanzee wearing overalls frolics in the grassy field, gently playing with butterflies. In the background, a circus tent and carousel beckon.",
    "image_urls": [
        "https://example.com/example_inputs/veo31-r2v-input-1.png",
        "https://example.com/example_inputs/veo31-r2v-input-2.png",
        "https://example.com/example_inputs/veo31-r2v-input-3.png"
    ],
    "aspect_ratio": "16:9",
    "duration": "8s",
    "resolution": "720p",
    "generate_audio": true,
    "safety_tolerance": "4"
}'

Output

{
  "request_id": "veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Try Now

Webhook (Optional)

Add the X-Webhook-URL header to your submit request to receive a POST callback when the job completes — no polling required.

Webhook Headers

Header	Required	Default	Description
`X-Webhook-URL`	Yes (to enable)	—	HTTPS endpoint on your server that will receive the `POST` callback. Must respond `2xx` within a few seconds (process async if needed).
`X-Webhook-Mode`	No	`terminal`	`terminal` — fires once at the final status (`COMPLETED`/`FAILED`/`ERROR`). `sync` — fires on every poll cycle plus the terminal event, and caps the queue’s polling delay at 15s for tighter progress updates.

Example: enable webhook

X-Webhook-URL: https://your-server.com/webhook/callback
X-Webhook-Mode: terminal

Callback Payload

Your endpoint receives a POST application/json with the same shape as the GET /v2/requests/status/{request_id} response. Example terminal callback (mode terminal):

{
  "request_id": "veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "veo-3-1-fast-reference-to-video",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.mp4"
    ],
    "media_type": "video/mp4"
  },
  "created_at": "2026-05-22T13:17:32.110Z",
  "updated_at": "2026-05-22 13:19:23",
  "completed_at": "2026-05-22 13:19:23"
}

Failure callback shape

{
  "request_id": "veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "veo-3-1-fast-reference-to-video",
  "error": "Description of the error",
  "output": null,
  "created_at": "...",
  "updated_at": "...",
  "completed_at": "..."
}

Delivery semantics

terminal mode (default) — exactly one POST when the request reaches a terminal status. No callback during PROCESSING.
sync mode — POST on every status poll (with delay capped at ~15s) plus a final POST at terminal status. Use when you want progress updates.
Idempotency — use request_id as your idempotency key. Network retries can deliver the same callback more than once; your handler must tolerate duplicates.
Response — respond 200 OK within a few seconds. The queue does not block on slow handlers, but persistent failures may stop further deliveries.
HTTPS required — plain http:// URLs are rejected.

Request Parameters - Veo 3.1 Fast Reference to Video generate request

Parameter	Required	Type	Default	Allowed values / range	Description
prompt	Yes	string	—	—	Text description of the video to generate. Must be detailed and specific for optimal results.
image_urls	Yes	string[]	—	—	Array of HTTP/HTTPS URLs pointing to reference images that anchor subject appearance for consistency. At least one image is required.
aspect_ratio	No	enum	"16:9"	"16:9", "9:16"	Aspect ratio of the output video.
duration	No	string	"8s"	4s–16s	Length of the generated video. Format must be numeric followed by "s" (e.g., "5s", "10s").
resolution	No	enum	"720p"	"720p", "1080p", "4k"	Output resolution of the video.
generate_audio	No	boolean	true	—	Whether to generate synchronized audio for the video. When enabled, pricing increases to $0.15 per second.
auto_fix	No	boolean	—	—	Automatically rewrites prompts that fail content policy checks. If omitted, policy violations will cause the request to fail.
safety_tolerance	No	enum	"4"	1, 2, 3, 4, 5, 6	Controls strictness of content safety filtering. Higher values are more permissive.

Example Request

{
  "prompt": "A chimpanzee wearing overalls frolics in the grassy field, gently playing with butterflies. In the background, a circus tent and carousel beckon.",
  "image_urls": [
    "https://example.com/example_inputs/veo31-r2v-input-1.png",
    "https://example.com/example_inputs/veo31-r2v-input-2.png",
    "https://example.com/example_inputs/veo31-r2v-input-3.png"
  ],
  "aspect_ratio": "16:9",
  "duration": "8s",
  "resolution": "720p",
  "generate_audio": true,
  "safety_tolerance": "4"
}

Response

{
  "request_id": "veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

Header	Value
Content-Type	application/json
Cache-Control	no-cache
Ocp-Apim-Subscription-Key	YOUR_API_KEY

Response Handling

Common status codes.

Code	Meaning
202	Accepted — Request queued
400	Bad Request
401	Unauthorized
402	Insufficient Balance
403	Forbidden
429	Too Many Requests
500	Internal Server Error

Error Responses

Queue system errors and model validation errors.

Queue System Errors

// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}

// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'veo-3-1-fast-reference-to-video' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "veo-3-1-fast-reference-to-video",
  "error": "Description of the error",
  "output": null
}

Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY

cURL Example

curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Response (Completed)

{
  "request_id": "veo-3-1-fast-reference-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "veo-3-1-fast-reference-to-video",
  "error": null,
  "output": { "media_url": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/veo-3-1-fast-reference-to-video_019dxxxx/output.mp4"], "media_type": "video/mp4" },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields

Field	Type	Description
request_id	string	Unique request identifier
status	string	QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR
model_id	string	Model that processed the request
error	string\|null	Error message if failed
output.media_url	array	URLs to generated media (R2 CDN)
output.media_type	string	MIME type of the output
created_at	string	When request was created
completed_at	string	When request completed
polling_url	string	Status URL (initial response only)

Status Values

Status	Description
QUEUED	Request accepted, waiting to be processed
PROCESSING	Being processed by the model
COMPLETED	Done — output contains the result
FAILED	Failed — check error field
ERROR	System error — not charged

Status Flow

QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR

Typical Workflow

Send a generate request to the API endpoint
Save the request_id from the response
Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
When status is "COMPLETED", download from output.media_url

Tip: Use X-Webhook-URL header to get a callback instead of polling.

Veo v3.1 Fast Reference to Video (Reference Images to Video) API Pricing

No data available

Could not load current pricing

2. Veo v3.1

Veo v3.1 Text to Video API Documentation

https://gateway.pixazo.ai/veo/v1

Authentication

All requests require an API key passed via header.

Header	Type	Required	Description
Ocp-Apim-Subscription-Key	string	Yes	Your API subscription key

Video Generation Request - Veo 3.1 API

Request Code

POST https://gateway.pixazo.ai/veo/v1/veo-3.1/generate
Content-Type: application/json
Ocp-Apim-Subscription-Key: your-subscription-key

{
  "prompt": "A serene lake with mountains in the background at sunset",
  "aspect_ratio": "16:9",
  "duration": 8,
  "resolution": "1080p",
  "generate_audio": true,
  "negative_prompt": "blur, distortion, low quality",
  "webhook": "https://your-server.com/webhook"
}

import requests

url = "https://gateway.pixazo.ai/veo/v1/veo-3.1/generate"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "your-subscription-key"
}
data = {
    "prompt": "A serene lake with mountains in the background at sunset",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p",
    "generate_audio": True,
    "negative_prompt": "blur, distortion, low quality",
    "webhook": "https://your-server.com/webhook"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

// Node.js example
const response = await fetch('https://gateway.pixazo.ai/veo/v1/veo-3.1/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Ocp-Apim-Subscription-Key': 'your-subscription-key'
  },
  body: JSON.stringify({
    prompt: 'A serene lake with mountains in the background at sunset',
    aspect_ratio: '16:9',
    duration: 8,
    resolution: '1080p',
    generate_audio: true,
    negative_prompt: 'blur, distortion, low quality',
    webhook: 'https://your-server.com/webhook'
  })
});

const data = await response.json();
console.log('Video ID:', data.id);
console.log('Status:', data.status);

curl -X POST https://gateway.pixazo.ai/veo/v1/veo-3.1/generate \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: your-subscription-key" \
  -d '{
    "prompt": "A serene lake with mountains in the background at sunset",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p",
    "generate_audio": true,
    "negative_prompt": "blur, distortion, low quality",
    "webhook": "https://your-server.com/webhook"
  }'

Output

{
  "request_id": "veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Try Now

Webhook (Optional)

Add the X-Webhook-URL header to your submit request to receive a POST callback when the job completes — no polling required.

Webhook Headers

Header	Required	Default	Description
`X-Webhook-URL`	Yes (to enable)	—	HTTPS endpoint on your server that will receive the `POST` callback. Must respond `2xx` within a few seconds (process async if needed).
`X-Webhook-Mode`	No	`terminal`	`terminal` — fires once at the final status (`COMPLETED`/`FAILED`/`ERROR`). `sync` — fires on every poll cycle plus the terminal event, and caps the queue’s polling delay at 15s for tighter progress updates.

Example: enable webhook

X-Webhook-URL: https://your-server.com/webhook/callback
X-Webhook-Mode: terminal

Callback Payload

Your endpoint receives a POST application/json with the same shape as the GET /v2/requests/status/{request_id} response. Example terminal callback (mode terminal):

{
  "request_id": "veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "veo-3-1",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.mp4"
    ],
    "media_type": "video/mp4"
  },
  "created_at": "2026-05-22T13:17:32.110Z",
  "updated_at": "2026-05-22 13:19:23",
  "completed_at": "2026-05-22 13:19:23"
}

Failure callback shape

{
  "request_id": "veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "veo-3-1",
  "error": "Description of the error",
  "output": null,
  "created_at": "...",
  "updated_at": "...",
  "completed_at": "..."
}

Delivery semantics

terminal mode (default) — exactly one POST when the request reaches a terminal status. No callback during PROCESSING.
sync mode — POST on every status poll (with delay capped at ~15s) plus a final POST at terminal status. Use when you want progress updates.
Idempotency — use request_id as your idempotency key. Network retries can deliver the same callback more than once; your handler must tolerate duplicates.
Response — respond 200 OK within a few seconds. The queue does not block on slow handlers, but persistent failures may stop further deliveries.
HTTPS required — plain http:// URLs are rejected.

Request Parameters - Video Generation Request

Parameter	Required	Type	Default	Allowed values / range	Description
`prompt`	Yes	string	—	—	Text description of the video to generate.
`aspect_ratio`	No	string	`"16:9"`	`"16:9"`, `"9:16"`	Output aspect ratio.
`duration`	No	integer	8	`4`, `6`, `8` (seconds)	Length of the generated video.
`resolution`	No	string	`"720p"`	`"720p"`, `"1080p"`	Output resolution. 1080p requires `duration` = 8.
`generate_audio`	No	boolean	`true`	`true`, `false`	Generate synchronized audio with the video.
`negative_prompt`	No	string	—	—	Elements to exclude from the generated video.
`image`	No	string	—	HTTP(S) URL	Input image for image-to-video (starting frame). Use a 720p-or-higher source.
`last_frame`	No	string	—	HTTP(S) URL	Ending frame for interpolation. Requires `image`.
`reference_images`	No	array	—	1–3 HTTP(S) URLs	Reference images for subject-consistent generation (R2V).
`seed`	No	integer	—	—	Random seed for reproducible results.
`webhook`	No	string	—	HTTPS URL	Webhook URL for completion notifications.
`webhook_events_filter`	No	array	—	`["start", "completed"]`	Event types to receive on the webhook.

Output: MP4, 24 fps, with an embedded Google SynthID watermark. 1080p output requires duration = 8.

Example Request

{
  "prompt": "A serene lake with mountains in the background at sunset",
  "aspect_ratio": "16:9",
  "duration": 8,
  "resolution": "1080p",
  "generate_audio": true,
  "negative_prompt": "blur, distortion, low quality",
  "webhook": "https://your-server.com/webhook"
}

Response

{
  "request_id": "veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

Header	Value
Content-Type	application/json
Ocp-Apim-Subscription-Key	Your subscription key

Response Handling

Common status codes.

Code	Meaning
202	Accepted — Request queued
400	Bad Request
401	Unauthorized
402	Insufficient Balance
403	Forbidden
429	Too Many Requests
500	Internal Server Error

Error Responses

Queue system errors and model validation errors.

Queue System Errors

// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}

// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'veo-3-1' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "veo-3-1",
  "error": "Description of the error",
  "output": null
}

Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY

cURL Example

curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Response (Completed)

{
  "request_id": "veo-3-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "veo-3-1",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/veo-3-1_019dxxxx-xxxx/output.ext"
    ],
    "media_type": "application/octet-stream"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields

Field	Type	Description
request_id	string	Unique request identifier
status	string	QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR
model_id	string	Model that processed the request
error	string\|null	Error message if failed
output.media_url	array	URLs to generated media (R2 CDN)
output.media_type	string	MIME type of the output
created_at	string	When request was created
completed_at	string\|null	When request completed
polling_url	string	Status URL (initial response only)

Status Values

Status	Description
QUEUED	Request accepted, waiting to be processed
PROCESSING	Being processed by the model
COMPLETED	Done — output contains the result
FAILED	Failed — check error field
ERROR	System error — not charged

Status Flow

QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR

Typical Workflow

Send a generate request to the API endpoint
Save the request_id from the response
Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
When status is "COMPLETED", download from output.media_url

Tip: Use X-Webhook-URL header to get a callback instead of polling.

Veo v3.1 Text to Video API Pricing

Resolution	Duration	Price (USD)
720p	4s	$1.8
720p	6s	$2.7
720p	8s	$3.6
1080p	4s	$2.4
1080p	6s	$3.6
1080p	8s	$4.8