Hailuo 视频生成

提交 Hailuo 视频生成任务。

请求地址仍为 POST /v1/video/generations，完成后用 GET /v1/video/generations/{task_id} 查询。

02、2.3、2.3-fast 是文生和首帧。首帧写 metadata.content，role=first_frame。时长 6 或 10，分辨率写 resolution：768P、1080P。不传 ratio。

H3 另支持参考生和首尾帧。时长为 4–15 秒。分辨率写 resolution，还可传 2K、4K。宽高比写 ratio；首尾帧不传 ratio，比例跟随图片。

非法参数原样交给上游，由上游拒绝。

各版本能力与字段说明见下方接口文档。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型 ID。

模型	说明
Hailuo 02	文生、首帧。时长 `6` / `10`，分辨率 `768P` / `1080P`
Hailuo 2.3	同 02
Hailuo 2.3 Fast	同 02
Hailuo H3	文生、参考生、首尾帧。时长 `4`–`15` 秒。分辨率写 `resolution`，宽高比写 `ratio`

prompt?string

文本描述提示词。t2v 模式必填；i2v / 参考图模式建议填写以精确描述运动效果。

duration?number

视频时长（秒）。02、2.3、2.3-fast 为 6 或 10，不传时上游默认 6。H3 为 4–15 的整数。不在我们这里收成最近合法值，上游不接受就报错。

resolution?string

分辨率。02、2.3、2.3-fast 为 768P、1080P，不传时上游默认 768P。H3 还可传 2K、4K。

ratio?string

宽高比，只给 H3 的文生和参考生。取值 21:9、16:9、4:3、1:1、3:4、9:16。首尾帧不传，比例跟随图片。02、2.3、2.3-fast 不传。

seed?integer

随机种子，控制生成结果可复现性。全部模型支持。

metadata?

扩展参数。02、2.3、2.3-fast 只使用首帧。H3 尾帧须与首帧一起传。

字段	类型	说明
`content`	array	素材列表。见下方元素字段
`negative_prompt`	string	反向提示词
`enhance_prompt`	string	自动优化提示词，`Enabled` / `Disabled`
`enhance_switch`	string	视频超分增强，`Enabled` / `Disabled`

`content` 元素结构

字段	类型	说明
`type`	string	`image_url`
`role`	string	见下表
`image_url.url`	string	图片地址

role 取值：

role	适用 type	说明
`first_frame`	image_url	首帧。必须显式填写，省略时按参考图提交
`last_frame`	image_url	尾帧。仅 H3，须与首帧一起传
`reference_image`	image_url	参考图。仅 H3

Response Body

application/json

curl -X POST "https://loading/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-video-2.3",
    "prompt": "海浪拍打礁石，浪花四溅",
    "resolution": "1080P",
    "duration": 6
  }'

curl -X POST "https://loading/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "hailuo-video-2.3",    "prompt": "海浪拍打礁石，浪花四溅",    "resolution": "1080P",    "duration": 6  }'

{
  "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
  "status": "queued"
}

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Authorization

Request Body

content 元素结构

Response Body

200application/json

400application/json

`content` 元素结构

application/json

application/json