curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "hailuo-03",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise",
"duration": 5,
"resolution": "2K",
"aspect_ratio": "16:9"
}
}
'
{
"code": 200,
"message": "success",
"data": {
"task_id": "8FDN1I7M7Q68DDG8"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Hailuo
Hailuo 03
根据文本、关键帧或多模态参考生成 2K 视频
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": "hailuo-03",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise",
"duration": 5,
"resolution": "2K",
"aspect_ratio": "16:9"
}
}
'
{
"code": 200,
"message": "success",
"data": {
"task_id": "8FDN1I7M7Q68DDG8"
}
}{
"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，都可以通过统一的查询任务状态接口获取结果。
模型
- hailuo-03 — Hailuo 03
功能
- 文生视频：直接根据提示词生成视频。
- 图生视频：通过
image_urls提供一个起始帧和一个可选的结束帧。 - 参考生视频：通过参考图片、视频和音频引导生成结果。
- 2K 输出：当前输出分辨率固定为
2K。
输入模式
- 没有媒体输入时，请求使用文生视频模式。
image_urls会选择图生视频模式。它接受一个起始帧和一个可选的第二张结束帧。reference_image_urls、reference_video_urls或reference_audio_urls中任意一个都会选择参考生视频模式。image_urls不能与任何reference_*_urls字段同时使用。- 参考图片、视频和音频可以在同一个参考生视频请求中组合使用。
- 参考音频不能作为唯一的参考输入。请至少包含一张参考图片或一段参考视频。
注意事项
prompt为必填，最多 2,000 个字符。duration接受5到15秒的整数，默认为5。resolution当前只接受2K。- 文生视频支持
21:9、16:9、4:3、1:1、3:4和9:16。默认为16:9。 - 参考生视频支持相同的固定宽高比，另加
adaptive。默认为adaptive。 - 图生视频跟随第一张图片的宽高比，因此该模式不接受
aspect_ratio。 reference_image_urls最多接受 9 张图片。reference_video_urls最多接受 3 个视频片段。每个片段应为 2–15 秒，总时长最多 15 秒。reference_audio_urls最多接受 3 个音频片段。每个片段应为 2–15 秒，总时长最多 15 秒。- 在提示词中按模态和顺序引用参考素材，例如
Image 1、Video 1和Audio 1。 - 所有媒体 URL 都必须可公开访问且可直接下载。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
示例:
"success"
Show child attributes
Show child attributes