Hy โ
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 โ
| Item | Value |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 1.5 |
| Default value | ModelVersion=1.5 / Resolution=1080P |
| Guardrail disable support | Not supported |
Specifications Supported by Version โ
| Version | Resolution | Aspect ratio | Length |
|---|---|---|---|
| Common | 480P / 720P / 1080P / 2K / 4K | โ | โ |
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Hunyuan |
ModelVersion | Optional | String | 1.5 |
Prompt | Required | String | Generation prompt |
FileInfos.N | Optional | Array | Reference input. Usage is FirstFrame (first frame) or Reference (reference) |
OutputConfig.Resolution | Optional | String | 480P / 720P / 1080P / 2K / 4K |
OutputConfig.Duration | Optional | Integer | Video length (seconds) |
OutputConfig.AspectRatio | Optional | String | 16: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
}
}
]
}
}
}