curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "h3-max-turbo",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1790245800-h3turbo1",
"status": "not_started",
"created_time": "2026-09-24T10:30:00Z"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Hailuo
H3 Max Turbo
根据文本、首帧或首尾帧生成视频
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": "h3-max-turbo",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1790245800-h3turbo1",
"status": "not_started",
"created_time": "2026-09-24T10:30:00Z"
}
}{
"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，都可以通过统一的查询任务状态接口获取结果。
模型
- h3-max-turbo — H3 Max Turbo
功能
- 文生视频： 不传
image_urls或传空数组。 - 首帧： 在
image_urls中提供一张图片。 - 首尾帧： 在
image_urls中提供两张图片，起始帧在前，结束帧在后。
image_urls 中包含图片，就不要传 aspect_ratio。
注意事项
- 所有模式下
prompt均为必填，最多 50,000 个字符。 duration接受5到15秒的整数，默认为5。resolution接受480p、768p或1080p，默认为768p。也接受大写P。enable_safety_checker(boolean) 为true时启用安全检查。所有模式下默认为true；设为false可关闭。- 文生视频支持
21:9、16:9、4:3、1:1、3:4和9:16。默认宽高比为16:9。 image_urls最多接受两个可公开访问的图片 URL 或 Base64 图片。- 该模型不支持参考媒体、自定义音轨、seed 和提示词扩展控制。
授权
所有 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