Veo 视频生成
通过 AceDataCloud 的 Google Veo API 生成 AI 视频。
设置: 有关令牌设置,请参阅 认证。
快速开始
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"}'
异步: 请参阅 异步任务轮询。通过
POST /veo/tasks并携带{"id": "..."}进行轮询。 这会立即返回一个任务 ID。轮询获取结果:
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>"}'
模型
| 模型 | 音频 | 最佳用途 |
|---|---|---|
veo2 | 否 | 经济高效的生成 |
veo2-fast | 否 | 快速、经济高效的生成(默认) |
veo3 | 是(原生) | 完整视听生成 |
veo3-fast | 是(原生) | 更快的视听生成 |
veo31 | 是(原生) | Veo 3.1,最高质量 |
veo31-fast | 是(原生) | Veo 3.1 快速变体 |
veo31-fast-ingredients | 是(原生) | Veo 3.1 快速,成分模式 |
工作流程
1. 文本转视频
POST /veo/videos
{
"action": "text2video",
"prompt": "cinematic aerial shot of the Northern Lights over Iceland",
"model": "veo3",
"resolution": "1080p"
}
2. 图像转视频
将静态图像动画化为视频。
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": "veo2",
"aspect_ratio": "16:9"
}
3. 成分转视频(多图像混合)
将 1–3 张参考图像混合成视频(仅 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. 放大至 1080p
将先前生成的视频转换为完整的 1080p 分辨率。
POST /veo/videos
{
"action": "get1080p",
"video_id": "your-video-id",
"model": "veo3"
}
参数
| 参数 | 值 | 描述 |
|---|---|---|
action | "text2video", "image2video", "ingredients2video", "get1080p" | 生成模式 |
model | 见模型表 | 要使用的模型(默认:veo2-fast) |
resolution | "4k", "1080p", "gif" | 输出分辨率(默认:720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | 宽高比——仅对 image2video 有效 |
image_urls | 字符串数组 | 参考图像 URL——用于 image2video(最多 2 张)或 ingredients2video(最多 3 张) |
video_id | 字符串 | 要放大的视频——仅用于 get1080p |
translation | true / false | 自动将提示翻译为英文(默认:false) |
生成后端点
生成视频后,使用这些端点进一步处理:
上采样(POST /veo/upsample)
将生成的视频放大至 1080p、4K 或转换为 GIF。
POST /veo/upsample
{
"video_id": "your-video-id",
"action": "4k"
}
| 参数 | 值 | 描述 |
|---|---|---|
video_id | 字符串 | 来自 /veo/videos、/veo/extend、/veo/reshoot 或 /veo/objects 的任务 ID |
action | "1080p", "4k", "gif" | 上采样目标 |
扩展(POST /veo/extend)
延续现有视频——AI 自动生成下一段。
POST /veo/extend
{
"video_id": "your-video-id",
"model": "veo31-fast",
"prompt": "the camera slowly zooms out"
}
| 参数 | 值 | 描述 |
|---|---|---|
video_id | 字符串 | 来自 /veo/videos 或先前 /veo/extend 的任务 ID |
model | "veo31-fast", "veo31" | 仅支持 Veo 3.1 系列 |
prompt | 字符串 | 可选:引导扩展的片段 |
重新拍摄(POST /veo/reshoot)
重新渲染视频,保留相同内容但应用新的摄像机运动。
POST /veo/reshoot
{
"video_id": "your-video-id",
"motion_type": "LEFT_TO_RIGHT"
}
| 参数 | 值 | 描述 |
|---|---|---|
video_id | 字符串 | 来自 /veo/videos 的任务 ID(不能使用 /veo/extend 的输出) |
motion_type | 见下表 | 要应用的摄像机运动 |
motion_type 值:
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
对象(POST /veo/objects)
使用基于蒙版的图像修复在视频中插入或移除对象。
POST /veo/objects
{
"video_id": "your-video-id",
"action": "insert",
"prompt": "add a flying bird"
}
POST /veo/objects
{
"video_id": "your-video-id",
"action": "remove",
"image_mask": "https://example.com/mask.jpg"
}
| 参数 | 值 | 描述 |
|---|---|---|
video_id | 字符串 | 任务 ID(不能使用 /veo/extend 的输出) |
action | "insert", "remove" | 操作类型 |
prompt | 字符串 | insert 必需;remove 可选 |
image_mask | 字符串 | URL 或 base64 JPEG——白色像素 = 目标区域。remove 必需;insert 可选 |
注意事项
- Veo 3 和 3.1 模型生成原生音频——
veo2/veo2-fast不支持音频 get1080p操作使用video_id(来自先前的生成),而不是 URLaspect_ratio仅对image2video操作有效image_urls接受数组——image2video最多 2 张图像,ingredients2video最多 3 张veo31-fast-ingredients需要图像输入——不能进行纯文本生成translation: true在发送到 Veo 之前自动翻译中文或其他非英文提示- 任务轮询使用
id(而不是task_id)作为/veo/tasks请求体 - 任务状态使用
"succeeded"(而不是 "completed")——轮询时检查此值 /veo/extend的输出不能用作/veo/reshoot或/veo/objects的输入
MCP:
pip install mcp-veo| 托管:https://veo.mcp.acedata.cloud/mcp| 请参阅 所有 MCP 服务器