Veo Video Generation

Generate AI videos through AceDataCloud's Google Veo API.

Setup: See [authentication](../_shared/authentication.md) for token setup.

Quick Start

curl -X POST https://api.acedata.cloud/veo/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "a whale breaching in slow motion at golden hour", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'

Async: See [async task polling](../_shared/async-tasks.md). Poll via POST /veo/tasks with {"id": "..."}.

This returns a task ID immediately. Poll for the result:

curl -X POST https://api.acedata.cloud/veo/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "<task_id from above>"}'

Models

Workflows

1. Text-to-Video

POST /veo/videos
{
  "action": "text2video",
  "prompt": "cinematic aerial shot of the Northern Lights over Iceland",
  "model": "veo3",
  "resolution": "1080p"
}

2. Image-to-Video

Animate still images into video.

POST /veo/videos
{
  "action": "image2video",
  "prompt": "the scene gently comes to life with wind and subtle motion",
  "image_urls": ["https://example.com/landscape.jpg"],
  "model": "veo31-fast",
  "aspect_ratio": "16:9"
}

3. Ingredients-to-Video (Multi-Image Blend)

Blend 1–3 reference images into a video (only veo31-fast-ingredients).

POST /veo/videos
{
  "action": "ingredients2video",
  "image_urls": [
    "https://example.com/img1.jpg",
    "https://example.com/img2.jpg"
  ],
  "model": "veo31-fast-ingredients"
}

4. Upscale to 1080p

Convert a previously generated video to full 1080p resolution.

POST /veo/videos
{
  "action": "get1080p",
  "video_id": "your-video-id",
  "model": "veo3"
}

Parameters

Gotchas

• Veo 3 and 3.1 models generate native audio
• The get1080p action uses video_id (from a prior generation), not a URL
• aspect_ratio is only valid for the image2video action
• image_urls accepts an array — up to 2 images for image2video, up to 3 for ingredients2video
• veo31-fast-ingredients requires image input — it cannot do text-only generation
• Documented aspect_ratio values are only "16:9" and "9:16"
• translation: true auto-translates Chinese or other non-English prompts before sending to Veo
• Task polling uses id (not task_id) in the /veo/tasks request body
• Task states use "succeeded" (not "completed") — check for this value when polling

MCP: pip install mcp-veo | Hosted: https://veo.mcp.acedata.cloud/mcp | See [all MCP servers](../_shared/mcp-servers.md)