curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "pixverse-v6-max",
"input": {
"prompt": "A blue glass marble rolls across a clean white table in warm morning light",
"duration": 5,
"resolution": "540p",
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1792190000-example",
"status": "not_started",
"created_time": "2026-10-28T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}PixVerse
PixVerse V6 Max
根据文本或一张图片生成 1–15 秒、360p 到 1080p 的视频，可选生成原生音频。
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": "pixverse-v6-max",
"input": {
"prompt": "A blue glass marble rolls across a clean white table in warm morning light",
"duration": 5,
"resolution": "540p",
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1792190000-example",
"status": "not_started",
"created_time": "2026-10-28T10: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，都可以通过统一的查询任务状态接口获取结果。
模型
- pixverse-v6-max — 文生视频和单图生视频
功能
- 生成 1 到 15 秒的视频。
- 根据文本创建短片，或让恰好一张图片动起来。
- 可选择 360p、540p、720p 或 1080p 输出。
- 可选生成原生音轨。
输入模式
- 文生视频：不传
image_urls。prompt为必填。aspect_ratio决定画面比例。 - 图生视频：在
image_urls中提供恰好一个 URL。prompt为可选。输出跟随图片，因此不要传aspect_ratio。
必填参数
prompt(string)：文生视频时必填。长度必须为 1–5,000 个字符，且不能为空白。image_urls(array of strings)：图生视频时必填。必须包含恰好一个公开图片 URL。
可选参数
prompt(string)：图生视频时可选，最多 2,048 个字符。提供时不能为空白。duration(integer)：输出时长，1 到 15 秒。默认为5。resolution(string)：360p、540p、720p或1080p。默认为540p。aspect_ratio(string)：16:9、9:16、4:3、3:4、1:1、2:3、3:2或21:9。默认为16:9。仅用于文生视频。audio(boolean)：生成原生音轨。默认为false。
示例
请求示例展示了一个指定画面比例的文生视频短片，以及一个不传aspect_ratio 的图片动画。两者都使用 pixverse-v6-max model ID。
注意事项
- 所有生成参数都放在
input中。 - 图生视频接受一张通过公开 HTTP 或 HTTPS URL 提供的 JPEG、PNG 或 WebP 图片。
- 不要传两张及以上图片、首尾帧或源视频。
- 像素尺寸遵循所选分辨率下模型的原生输出。
授权
所有 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