Hy โ
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Hy Video is Tencent Hunyuan's video generation model, supporting text-to-video and image-to-video, and it can take both a first frame and a last frame. It works as a general-purpose base generation engine.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 1.5 |
| Guardrail disable support | Not supported |
This is the default engine that supports text-to-video and image-to-video. The first frame and last frame can be specified together.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Hunyuan |
ModelVersion | Optional | String | 1.5 |
Prompt | Required | String | Generation prompt. In text input mode, write up to a maximum of 2000 characters |
NegativePrompt | Optional | String | Elements to exclude from the result. Applied on supported models |
EnhancePrompt | Optional | Boolean | Automatic prompt correction. Default value false |
ImageUrl | Optional | String | First frame image URL. Must be externally accessible and 10MB or less |
LastImageUrl | Optional | String | Last frame image URL. Used together with ImageUrl |
ImageInfos.N | Optional | Array | Reference image array. Category / Url / ReferenceType, etc. |
Duration | Optional | Integer | Generation length (seconds). Only allowed values per model are applied |
ExtraParameters | Optional | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters | Optional | String | JSON string containing model-specific options. For the seed delivery format, see Additional configuration reference |
Request Example โ
image-to-video (first / last frame) โ
json
{
"ModelName": "Hunyuan",
"ModelVersion": "1.5",
"Prompt": "move the picture",
"NegativePrompt": "top lighting, oversaturated colors",
"EnhancePrompt": false,
"ImageUrl": "https://<cdn>/first.png",
"LastImageUrl": "https://<cdn>/last.png",
"Duration": 5,
"ExtraParameters": {
"Resolution": "720P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}Response 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>"
}
}