curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo3.1-fast-official",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic close-up of a paper boat drifting through a neon-lit canal",
"duration": 6,
"aspect_ratio": "16:9",
"resolution": "1080p",
"sound": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1780000000-veo31official",
"status": "not_started",
"created_time": "2026-05-20T10:30:00"
}
}Google
Veo 3.1 Official
官方 VEO 3.1 视频生成，支持时长、音频控制和图片引导模式
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo3.1-fast-official",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic close-up of a paper boat drifting through a neon-lit canal",
"duration": 6,
"aspect_ratio": "16:9",
"resolution": "1080p",
"sound": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1780000000-veo31official",
"status": "not_started",
"created_time": "2026-05-20T10:30:00"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- veo3.1-fast-official - 快速官方生成，时长可选
4、6或8秒 - veo3.1-lite-official - 轻量官方生成，按秒计费单价更低
- veo3.1-quality-official - 更高质量的官方生成，支持 4K
输入模式
- 不传
image_urls：文生视频 - 一张图片：图生视频
- 两张图片：首尾帧视频。第一张图片为起始帧，第二张图片为结束帧
- 三张图片：参考图生成。使用
generation_type: "reference"和duration: 8 veo3.1-lite-official最多支持两张图片，且不支持generation_type: "reference"
参数
- model：必填的模型标识。使用
veo3.1-fast-official、veo3.1-lite-official或veo3.1-quality-official - prompt：必填的视频生成文本提示词，最多
1000个字符 - image_urls：可选的图片 URL 数组。最多支持
3个公开图片 URL - generation_type：可选
frame或reference。省略时根据image_urls推断模式 - duration：
4、6或8，默认8。参考图生成以及resolution: "1080p"下的veo3.1-lite-official仅支持8 - aspect_ratio：
16:9或9:16。单图和双图工作流还支持auto。默认16:9 - resolution：
720p、1080p或4k，默认1080p。veo3.1-lite-official不支持4k - sound：布尔型音频开关。默认
true；设为false输出无声视频 - callback_url：可选的 Webhook URL，用于接收任务完成或失败通知
定价
按生成的秒数计费，具体因模型、分辨率以及是否生成音频而异。当前积分表见模型页面。工作流 ID
现有 ID 继续可用。新接入可以选择专用的工作流：- google/veo3.1/text-to-video
- google/veo3.1/image-to-video
- google/veo3.1-fast/text-to-video
- google/veo3.1-fast/image-to-video
- google/veo3.1-lite/text-to-video
- google/veo3.1-lite/image-to-video
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key：
进入 仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key
在请求头中添加：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json