curl --request POST \
--url https://api.poyo.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-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-05-18T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Google
VEO 3.1 Official
VEO 3.1 Official API 可根据文本或图片生成 4、6 或 8 秒的视频，可选输出无声视频。quality 模型可输出 4K；三张参考图片时时长固定为 8 秒。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.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-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-05-18T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
generation_type 驱动的三图生成。
模型
- veo3.1-fast-official - 快速官方生成，时长可选 4、6 或 8 秒
- veo3.1-lite-official - 轻量官方生成
- veo3.1-quality-official - 更高质量的官方生成，支持 4K
输入模式
生成模型
- 不传
image_urls：文生视频 - 一张图片：图生视频
- 两张图片：首尾帧视频；
veo3.1-lite-official仅在 8 秒时支持此模式 - 三张图片：
generation_type: "reference"，时长固定为 8 秒 veo3.1-lite-official最多支持两张图片，不支持generation_type: "reference"
必填参数
- prompt：必填的文本提示词
可选参数
- image_urls：生成模型可选的图片 URL 数组
- generation_type：可选，
frame或reference；如果省略，PoYo 会根据image_urls推断模式；veo3.1-lite-official传两张图片时仍需duration: 8 - duration：生成模型支持
4、6或8；generation_type: "reference"搭配三个image_urls时仅支持8；veo3.1-lite-official搭配两个image_urls时仅支持8；veo3.1-lite-official搭配resolution: "1080p"时仅支持8 - aspect_ratio：
16:9或9:16；图生视频和首尾帧生成还支持auto - resolution：在支持的模型上可选
720p、1080p或4k；veo3.1-lite-official不支持4k - sound：默认为
true；设为false输出无声视频
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
Show child attributes
Show child attributes