跳到内容

Hailuo ​

更新时间

Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask

Hailuo 是视频生成模型,支持文生视频、首帧 / 首尾帧生视频。H3 支持图片、视频、音频混合输入的多模态参考生成(图片 9 张 / 视频 3 个 / 音频 3 个,合计 12 个);02 与 2.3 系列是时长固定的简单生成引擎。

基本信息 ​

项目值
ModelNameHailuo
ModelVersionH3 / 2.3 / 2.3-fast / 02
护栏解除支持仅支持 H3

各版本支持规格 ​

版本分辨率比例时长
H3默认输出:768P
超分输出:1080P / 2K / 4K
21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:164–15 秒
H3-Max默认输出:480P / 768P
超分输出:1080P / 2K / 4K
16:9 / 9:16 / 4:3 / 3:4 / 1:1 / adaptive5–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选填StringH3 / 2.3 / 2.3-fast / 02
Prompt必填String生成 Prompt。请参考下方各版本限制
NegativePrompt选填String结果中需排除的元素。适用于支持的模型
EnhancePrompt选填BooleanPrompt 自动校正。默认值 false
ImageUrl选填String首帧图片 URL。需可外部访问且不超过 10MB
LastImageUrl选填String尾帧图片 URL。与 ImageUrl 一同使用
ImageInfos.N选填Array参考图片数组。Category / Url / ReferenceType 等
Duration选填Integer生成时长(秒)。仅生效模型允许的值
ExtraParameters选填ObjectResolution / 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.EnablelnputComplianceCheckfalse输入审核解除
ExtraParameters.EnableOutputComplianceCheckfalse输出审核解除

将以下配置合并到已有的生成请求中。如需同时解除输入与输出审核,请一并传入两个字段。

json
{
  "ExtraParameters": {
    "EnablelnputComplianceCheck": false,
    "EnableOutputComplianceCheck": false
  }
}

各版本支持能力 ​

版本生成模式时长备注
H3text / image / 多模态参考4~15 秒参考图片 9 个、视频 3 个、音频 3 个。原生语音生成
2.3text / image6 秒, 10 秒1080P 仅 6 秒
2.3-fast仅 image6 秒, 10 秒首帧必填
02text / 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 模式。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages