Skip to content

Hy โ€‹

Updated

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

Hy Video is Tencent Hunyuan's video generation model, supporting text-to-video and first-frame image-to-video. Output resolution ranges from 480P to 4K, making it a general-purpose base generation engine.

Basic Information โ€‹

ItemValue
ModelNameHunyuan
ModelVersion1.5
Default valueModelVersion=1.5 / Resolution=1080P
Guardrail disable supportNot supported

Specifications Supported by Version โ€‹

VersionResolutionAspect ratioLength
Common480P / 720P / 1080P / 2K / 4Kโ€”โ€”

Request Parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Hunyuan
ModelVersionOptionalString1.5
PromptRequiredStringGeneration prompt
FileInfos.NOptionalArrayReference input. Usage is FirstFrame (first frame) or Reference (reference)
OutputConfig.ResolutionOptionalString480P / 720P / 1080P / 2K / 4K
OutputConfig.DurationOptionalIntegerVideo length (seconds)
OutputConfig.AspectRatioOptionalString16:9 / 9:16 / 1:1, etc.

Request Example โ€‹

json
{
  "SubAppId": 123456789,
  "ModelName": "Hunyuan",
  "ModelVersion": "1.5",
  "Prompt": "a calm sunset over the ocean, cinematic",
  "OutputConfig": {
    "Resolution": "1080P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

Response Example โ€‹

json
{
  "AigcVideoTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcVideoGenFile.mp4",
          "ExpireTime": "2026-08-01T10:29:48Z",
          "MetaData": {
            "Width": 1920,
            "Height": 1080,
            "Duration": 5.07,
            "Container": "mov,mp4,m4a",
            "Bitrate": 9494850
          }
        }
      ]
    }
  }
}

Built with VitePress ยท Deployed on Tencent EdgeOne Pages