Hailuo
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Hailuo 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频。H3 支持图片、视频、音频混合输入的多模态参考生成(图片 9 张 / 视频 3 个 / 音频 3 个,合计 12 个);02 与 2.3 系列是时长固定的简单生成引擎。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | Hailuo |
| ModelVersion | H3 / 2.3 / 2.3-fast / 02 |
| 护栏解除支持 | 仅支持 H3 |
各版本支持规格
| 版本 | 分辨率 | 比例 | 时长 |
|---|---|---|---|
H3 | 默认输出:768P超分输出: 1080P / 2K / 4K | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 | 4–15 秒 |
H3-Max | 默认输出:480P / 768P超分输出: 1080P / 2K / 4K | 16:9 / 9:16 / 4:3 / 3:4 / 1:1 / adaptive | 5–15 秒 |
02 / 2.3 | 请参考各版本输出选项 | — | 6 秒10 秒 |
输入条件
| 版本 | 条件 |
|---|---|
H3 | 输入:参考图片 9 张 / 视频 3 个 / 音频 3 个,合计 12 个;与首/尾帧模式分开 |
H3-Max | 输入:文本或首/尾帧 |
02 / 2.3 | 输入:不应用 H3 多模态限制 |
02 与 2.3 系列是时长固定的简单生成引擎,H3 是同时参考图片、视频、音频的多模态引擎。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Hailuo |
ModelVersion | 选填 | String | H3 / 2.3 / 2.3-fast / 02 |
Prompt | 必填 | String | 生成 Prompt。请参考下方各版本限制 |
NegativePrompt | 选填 | String | 结果中需排除的元素。适用于支持的模型 |
EnhancePrompt | 选填 | Boolean | Prompt 自动校正。默认值 false |
ImageUrl | 选填 | String | 首帧图片 URL。需可外部访问且不超过 10MB |
LastImageUrl | 选填 | String | 尾帧图片 URL。与 ImageUrl 一同使用 |
ImageInfos.N | 选填 | Array | 参考图片数组。Category / Url / ReferenceType 等 |
Duration | 选填 | Integer | 生成时长(秒)。仅生效模型允许的值 |
ExtraParameters | 选填 | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters | 选填 | String | 存放模型专属选项的 JSON 字符串。seed 的传入格式请参考 附加配置 |
ExtraParameters.EnablelnputComplianceCheck | 选填 | Boolean | 显式传入 false 则解除输入审核。使用前请咨询商务负责人 |
ExtraParameters.EnableOutputComplianceCheck | 选填 | Boolean | 显式传入 false 则解除输出审核。使用前请咨询商务负责人 |
请求示例
text-to-video (H3)
H3 会反映 Prompt 中的镜头运动。默认输出分辨率为 2560x1440。
json
{
"ModelName": "Hailuo",
"ModelVersion": "H3",
"Prompt": "a girl running toward the camera on a playground holding a kite, orbit camera, cinematic quality",
"Operator": "wiki-example",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}H3-Max / 首/尾帧
json
{
"ModelName": "Hailuo",
"ModelVersion": "H3-Max",
"Prompt": "The camera moves from the first frame toward the final composition.",
"NegativePrompt": "blur, distortion",
"EnhancePrompt": false,
"ImageUrl": "https://<host>/first.jpg",
"LastImageUrl": "https://<host>/last.jpg",
"Duration": 5,
"ExtraParameters": {
"Resolution": "768P",
"AspectRatio": "16:9"
},
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"Operator": "wiki-example"
}响应示例
json
{
"Response": {
"Status": "DONE",
"Message": "ok",
"Resolution": "1920x1080",
"VideoUrls": [
"https://aigc-output-video-<id>.cos.<region>.myqcloud.com/<file>.mp4?q-sign-algorithm=sha1&..."
],
"RequestId": "<request-id>"
}
}特殊配置
护栏解除
Hailuo 仅在 ModelVersion=H3 中支持护栏解除。请勿对其他版本同样套用。
如需使用护栏解除参数,请先联系商务负责人确认使用权限。即使在支持该引擎的情况下,也只有显式传入相应参数时才会解除护栏。省略参数则不会解除。
| 参数 | 解除值 | 适用对象 |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck | false | 输入审核解除 |
ExtraParameters.EnableOutputComplianceCheck | false | 输出审核解除 |
将以下配置合并到已有的生成请求中。如需同时解除输入与输出审核,请一并传入两个字段。
json
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}各版本支持能力
| 版本 | 生成模式 | 时长 | 备注 |
|---|---|---|---|
H3 | text / image / 多模态参考 | 4~15 秒 | 参考图片 9 个、视频 3 个、音频 3 个。原生语音生成 |
2.3 | text / image | 6 秒, 10 秒 | 1080P 仅 6 秒 |
2.3-fast | 仅 image | 6 秒, 10 秒 | 首帧必填 |
02 | text / image,首+尾帧 | 6 秒, 10 秒 | 仅 16:9 |
H3 输入限制
图片输入(首帧、尾帧、参考图片)
| 项目 | 限制 |
|---|---|
| 格式 | JPG, JPEG, PNG, WEBP, HEIC, HEIF |
| 文件大小 | 30MB 以下 |
| 宽高范围 | 256~5760 px |
| 宽高比 | 0.4~2.5 |
| 数量 | 首帧 1 张、尾帧 1 张、参考图片 9 张 以下 |
视频输入(参考生成)
| 项目 | 限制 |
|---|---|
| 容器 | MP4, MOV |
| 编码 | 视频 H.264, H.265 / 音频 AAC, MP3 |
| 文件大小 | 50MB 以下 |
| 数量 | 3 个 以下 |
| 片段时长 | 2~15 秒,合计 15 秒 以下 |
| 宽高范围 | 256~5760 px |
| 宽高比 | 0.4~2.5 |
| 帧率 | 23.976~60 |
音频输入(参考生成)
| 项目 | 限制 |
|---|---|
| 格式 | WAV, MP3 |
| 文件大小 | 15MB 以下 |
| 数量 | 3 个 以下 |
| 片段时长 | 2~15 秒,合计 15 秒 以下 |
image-to-video(首 / 尾帧)
ImageUrl 与 LastImageUrl 各输入 1 张。首/尾帧(i2va)与多模态参考(r2va)作为独立的生成模式进行选择。
json
{
"ModelName": "Hailuo",
"ModelVersion": "H3",
"Prompt": "camera slowly pushes in",
"ImageUrl": "https://<cdn>/first.jpg",
"LastImageUrl": "https://<cdn>/last.jpg",
"Duration": 6,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "9:16"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}附加选项
i2va 与 r2va 互斥
参考视频 / 音频生成选择 r2va 模式,首/尾帧生成选择 i2va 模式。