curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "vidu-q4",
"input": {
"image_urls": [
"https://example.com/start-frame.png"
]
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1792190000-example",
"status": "not_started",
"created_time": "2026-10-17T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Vidu
Vidu Q4
根据一张起始帧或参考图片生成 3–16 秒的视频，可选附带参考音频，分辨率从 540p 到 4k。
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": "vidu-q4",
"input": {
"image_urls": [
"https://example.com/start-frame.png"
]
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1792190000-example",
"status": "not_started",
"created_time": "2026-10-17T10: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，都可以通过统一的查询任务状态接口获取结果。
模型
- vidu-q4 — 图生视频和参考生视频
功能
- 生成 3 到 16 秒的视频。
- 让一张起始帧图片动起来，或使用 1–12 张参考图片及最多 3 个可选参考音频文件引导视频。
- 可选择 540p 到 4k 的输出分辨率。
- 在参考生视频模式下可选生成音轨。
输入模式
- 图生视频：在
image_urls中提供恰好一个 URL。prompt为可选。此模式不能与reference_image_urls或reference_audio_urls同时使用，也不要传aspect_ratio或generate_audio。 - 参考生视频：提供
prompt，并在reference_image_urls中提供 1–12 个 URL。reference_audio_urls为可选，且必须与参考图片一起使用。不要传image_urls。
必填参数
prompt(string)：参考生视频时必填。长度必须为 1–5,000 个字符，且不能为空白。image_urls(array of strings)：图生视频时必填。必须包含恰好一个起始帧图片 URL。reference_image_urls(array of strings)：参考生视频时必填。必须包含 1–12 个参考图片 URL。
可选参数
prompt(string)：图生视频时可选，最多 5,000 个字符。reference_audio_urls(array of strings)：搭配reference_image_urls的可选音频，最多 3 个文件。每个文件必须为 MP3，时长 3–12 秒。没有参考图片时不能使用音频。duration(integer)：输出时长，3 到 16 秒。默认为5。resolution(string)：540p、720p、1080p、2k或4k。默认为720p。aspect_ratio(string)：16:9、9:16、4:3、3:4或1:1。默认为16:9。仅用于参考生视频。generate_audio(boolean)：生成音轨。默认为false。仅用于参考生视频。enable_safety_checker(boolean)：启用内容安全检查。默认为true。
示例
请求示例展示了带可选提示词的单张起始帧动画，以及由参考图片引导、可选附带音频的生成。两种模式使用同一个vidu-q4 model ID。
注意事项
- 所有生成参数都放在
input中。 - 图片必须使用可公开访问的 HTTP 或 HTTPS URL。
- 参考音频必须使用可公开访问的 HTTP 或 HTTPS URL。
- 图生视频会拒绝
aspect_ratio和generate_audio，即使generate_audio为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