Veo Video API Documentation

Overview

Text-to-video generation powered by Google DeepMind's Veo model. Produces high-definition, cinematic video clips from a text prompt or a reference image.

Primary Endpoint

POST/api/v1/veoVideo/start

Start Veo 3.1 video generation

Request Parameters

Name	Type	Required	Description
name	string	No	Name of the video generation task (optional, auto-generated if not provided)
prompt	string	Yes	Text prompt describing the video content. Can be empty to use default placeholder text.
generationType	enum: TEXT_2_VIDEO \| FIRST_AND_LAST_FRAMES_2_VIDEO \| REFERENCE_2_VIDEO	No	Type of generation (TEXT_2_VIDEO for text-only, FIRST_AND_LAST_FRAMES_2_VIDEO for image frames, REFERENCE_2_VIDEO for reference images)
imageUrls	array<string>	No	Image URLs for image-to-video generation. For FIRST_AND_LAST_FRAMES_2_VIDEO mode, 1-2 images (start/end frames). For REFERENCE_2_VIDEO mode, 1-3 reference images.
model	enum: veo3 \| veo3_fast	No	Generation model (veo3 for quality, veo3_fast for speed)
aspectRatio	enum: 16:9 \| 9:16 \| Auto	No	Video aspect ratio (Auto will determine automatically)
watermark	string	No	Custom watermark text (optional)
seeds	number	No	Random seed for reproducible generation (10000-99999, optional)
webhook_url	string	No	HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth.
webhook_token	string	No	Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e.

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/veoVideo/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My Veo Video",
  "prompt": "Two person street interview in New York City. Sample Dialogue: Host: \"Did you hear the news?\" Person: \"Yes! Veo 3.1 is now available on A2E. If you want to see it, go check their website.\"",
  "generationType": "TEXT_2_VIDEO",
  "imageUrls": [
    "https://example.com/start_frame.jpg",
    "https://example.com/end_frame.jpg"
  ],
  "model": "veo3_fast",
  "aspectRatio": "16:9",
  "watermark": "MyBrand",
  "seeds": 12345,
  "webhook_url": "https://your-server.example.com/a2e/webhook",
  "webhook_token": "a-shared-secret"
}'

Related Endpoints

POST/api/v1/veoVideo/start

Start Veo 3.1 video generation

GET/api/v1/veoVideo/allRecords

Get all Veo video records

POST/api/v1/veoVideo/batchDetail

Batch query task details

GET/api/v1/veoVideo/{_id}

Get Veo video detail

DELETE/api/v1/veoVideo/{_id}

Delete Veo video record

GET/api/v1/veoVideo/{_id}/1080p

Get 1080P HD video

Responses

200

Video generation task started successfully

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid or missing bearer token