API Documentation

Generate stunning AI videos with sound using the Veo 3.1 API. Simple REST API, pay only for successful generations.

Base URL

https://v1.veo3api.tech

🎬

8 sec videos

HD with audio

💰

$0.01/sec

Pay per success

⚡

~2 min

Generation time

Authentication

All API requests require an API key. Include it in the X-API-Key header.

curl https://v1.veo3api.tech/v1/balance \
  -H "X-API-Key: vfg_xxxxxxxxxxxxxxxxxxxx"

🔑 Get your API key: Register to receive your API key, or create a new one in Dashboard → Settings.

Errors

The API returns standard HTTP status codes and JSON error messages.

Code	Description
`400`	Bad Request — Invalid parameters
`401`	Unauthorized — Invalid API key
`402`	Payment Required — Insufficient balance
`404`	Not Found — Resource doesn't exist
`429`	Too Many Requests — Rate limit exceeded
`500`	Server Error — Something went wrong

Error Response Example:

{
  "error": true,
  "message": "Insufficient balance",
  "code": 402
}

Generate Video

Create a new video generation task.

POST /v1/generate

Request Body

Parameter	Type	Description
`prompt` *	string	Video description (10-1000 chars). Required.
`quality`	string	`720p`, `720p_high` (default), `1080p`, or `1080p_high`
`aspect_ratio`	string	`16:9` (default) or `9:16`
`webhook_url`	string	URL to receive completion notification

💡 Pricing (8 sec video duration):
• 720p (HD Video With Sound) = $0.01/sec ($0.08/video)
• 720p_high = $0.02/sec (faster queue)
• 1080p = $0.03/sec
• 1080p_high = $0.04/sec (faster queue)
All videos with sound, High quality

Example Request

curl -X POST https://v1.veo3api.tech/v1/generate \
  -H "X-API-Key: vfg_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A majestic eagle soaring through mountain peaks at golden hour, cinematic aerial shot",
    "quality": "1080p",
    "aspect_ratio": "16:9"
  }'

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending",
  "estimated_time": 150,
  "cost": 0.24,
  "quality": "1080p",
  "duration": 8,
  "queue_position": 3
}

Task Status

Get the current status of a video generation task.

GET /v1/task/{task_id}

Example Request

curl https://v1.veo3api.tech/v1/task/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: vfg_xxxxxxxxxxxxxxxxxxxx"

Response (Completed)

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "progress": 100,
  "video_url": "https://v1.veo3api.tech/v1/files/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "quality": "1080p",
  "created_at": "2025-01-23T12:00:00Z",
  "completed_at": "2025-01-23T12:02:15Z"
}

Status Values

`pending`	Task is queued
`processing`	Video is being generated
`completed`	Video ready for download
`retrying`	Retrying after error
`failed`	Generation failed (no charge)

Task List

Get a list of your video generation tasks.

GET /v1/tasks

Query Parameters

`limit`	Number of tasks (1-100, default 20)
`offset`	Pagination offset
`status`	Filter by status

curl "https://v1.veo3api.tech/v1/tasks?limit=10&status=completed" \
  -H "X-API-Key: vfg_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "tasks": [
    {
      "task_id": "a1b2c3d4-...",
      "status": "completed",
      "progress": 100,
      "video_url": "https://v1.veo3api.tech/v1/files/download/a1b2c3d4-...",
      "prompt": "A majestic eagle...",
      "quality": "720p_high",
      "aspect_ratio": "16:9",
      "created_at": "2025-01-23T12:00:00Z",
      "completed_at": "2025-01-23T12:02:15Z"
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0
}

Clear Tasks

Delete all completed and failed tasks from your history. Active tasks (pending, processing) are not affected.

DELETE /v1/tasks/clear

curl -X DELETE https://v1.veo3api.tech/v1/tasks/clear \
  -H "X-API-Key: vfg_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "success": true,
  "deleted": 15
}

Download Video

Download a generated video file. Videos are available for 24 hours.

GET /v1/files/download/{task_id}

curl -O https://v1.veo3api.tech/v1/files/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: vfg_xxxxxxxxxxxxxxxxxxxx"

💡 Tip: The video_url from task status already includes the full download URL.

Get Balance

Check your current account balance.

GET /v1/balance

curl https://v1.veo3api.tech/v1/balance \
  -H "X-API-Key: vfg_xxxxxxxxxxxxxxxxxxxx"

{
  "balance": 25.50,
  "currency": "USD"
}

Pricing

Get current pricing information. Prices are per second of video.

GET /v1/pricing

{
  "per_second": {
    "720p": 0.01,
    "720p_high": 0.02,
    "1080p": 0.03,
    "1080p_high": 0.04
  },
  "currency": "USD"
}

Pricing Table

Video	Price/sec	8 sec video	Note
`720p`	$0.01	$0.08	HD Video With Sound
`720p_high`	$0.02	$0.16	HD Priority, faster queue
`1080p`	$0.03	$0.24	Full HD
`1080p_high`	$0.04	$0.32	Full HD Priority, faster queue

All videos include synchronized audio and use High quality.

n8n Integration

Use the HTTP Request node to integrate with n8n workflows.

HTTP Request Node Settings

Method:POST

URL:https://v1.veo3api.tech/v1/generate

Authentication:Header Auth

Header Name:X-API-Key

Header Value:vfg_your_api_key

JSON Body:

{
  "prompt": "{{ $json.video_description }}",
  "webhook_url": "https://your-n8n-instance.com/webhook/video-ready"
}

Make.com Integration

Use the HTTP module to connect Make.com scenarios.

HTTP Module Configuration

Add HTTP "Make a request" module
Set URL: https://v1.veo3api.tech/v1/generate
Method: POST
Add header: X-API-Key with your API key
Body type: JSON
Add your prompt in the body

Zapier Integration

Use Webhooks by Zapier to integrate with your Zaps.

Webhooks by Zapier

Add "Webhooks by Zapier" action
Choose "Custom Request"
Method: POST
URL: https://v1.veo3api.tech/v1/generate
Headers: X-API-Key: vfg_xxx and Content-Type: application/json
Data: {"prompt": "your video description"}