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": "veo3-fast",
    "watermark": "veo"
  }'

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 between veo3 (high quality, 180 credits) or veo3-fast (fast generation, 25 credits)
`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": "veo3-fast",
  "watermark": "veo"
}

Response

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
  }
}

Credits Consumption

Model Type	Credits	Cost
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`extend`	Same as original	-
`get-1080p`	Free	$0.00

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": "veo3-fast",
      "watermark": "veo"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
  "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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Note: Only completed video tasks can be extended. Videos that have been 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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 Tip: This endpoint is completely free. You can get the 1080P version of any completed video without consuming credits.

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