Veo 3.1 API Documentation

Complete guide to integrate Google's AI video generation into your applications.

Quick Start Guide

Get up and running with the Veo 3.1 API in just a few minutes.

Get Your API Key

First, you'll need to obtain an API key from your dashboard.

Make Your First Request

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo4",
    "duration": 5,
    "resolution": "720p"
  }'

Check Generation Status

Video generation is asynchronous. Use the https://veo3api.com/feed endpoint to check status, or provide a

cURL

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

API Reference

Complete reference for all Veo 3.1 API endpoints, parameters, and response formats.

Base URL

https://veo3api.com

Endpoints do not use an /api prefix—call https://veo3api.com/ (for example https://veo3api.com/generate).

Authentication

All API requests require authentication using a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

POSThttps://veo3api.com/generate

Generate a video from text or image prompt

Request Body

Parameter	Type	Required	Description
`prompt`	string	*	The text prompt for video generation
`model`	string	*	Choose veo3 (high quality, 180 credits), veo3-fast (fast generation, 25 credits), or veo4 (duration- and resolution-based pricing; see the table below)
`duration`	integer		Veo 4 duration: 5, 10, or 15 seconds (default: 5)
`resolution`	string		Veo 4 output resolution: 480p, 720p (default), or 1080p
`aspect_ratio`	string		Aspect ratio: 16:9 (default, 1080P HD), 9:16 (portrait), or Auto (match image)
`image_urls`	string[]		Array of image URLs for image-to-video generation
`watermark`	string		Custom watermark text. Set to null for no watermark

Example Request

JSON

{
  "prompt": "a dog running",
  "model": "veo4",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16: 9"
}

Response

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n90a1b2c3d4e5f6sd20",
    "status": "IN_PROGRESS",
    "consumed_credits": 240,
    "model": "veo4"
  }
}

Credits Consumption

Model Type	Credits	Cost
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`veo4`480p · 5s / 10s / 15s	160 / 320 / 480 credits	$1.60 / $3.20 / $4.80
`veo4`720p · 5s / 10s / 15s	240 / 480 / 720 credits	$2.40 / $4.80 / $7.20
`veo4`1080p · 5s / 10s / 15s	360 / 720 / 1080 credits	$3.60 / $7.20 / $10.80
`extend`	Same as original	-
`get-1080p`	Free	$0.00

Veo 4 pricing is based on duration and resolution; text-to-video and image-to-video use the same rate.

Note: Credits are deducted only when the video generation is completed successfully. Failed tasks do not consume credits.

GEThttps://veo3api.com/feed

Check the status of a video generation task

Example Request

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

Response

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo4",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16: 9"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "consumed_credits": 240,
    "type": "text-to-video",
    "model": "veo4",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

💡 Tip: The generated video URL can be obtained from data.response array.

POSThttps://veo3api.com/extend

Extend an existing video with a new prompt. The extended video will continue from where the original video ended.

Request Body

Parameter	Type	Required	Description
`task_id`	string	*	The task_id of the original completed video to extend
`prompt`	string	*	The text prompt describing how to continue/extend the video
`seeds`	integer		Random seed (10000-99999) for reproducible generation. Same seed produces similar results
`watermark`	string		Custom watermark text. Set to null for no watermark

Example Request

JSON

{
  "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

Response

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Note: This endpoint supports only completed veo3 and veo3-fast tasks. It is not available for Veo 4 tasks, and videos converted to 1080P cannot be extended.

GEThttps://veo3api.com/get-1080pFree

Get the high-definition 1080P version of a completed video task. This endpoint is free and does not consume any credits.

Example Request

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

Response

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 Tip: This endpoint supports only completed veo3 and veo3-fast tasks. It is free and does not consume credits. Veo 4 can be generated directly in 1080p.

HTTP Status Codes

Status Code	Description
`200`	Request successful
`400`	Bad request - Invalid parameters
`401`	Unauthorized - Invalid API key
`429`	Rate limit exceeded
`500`	Internal server error