Hy HOT โ
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask
Hy Image is Tencent Hunyuan's image generation model, supporting text-to-image and reference-image generation / editing. 3.5-preview supports multi-turn re-editing based on the previous result.
Basic information โ
| Item | Value |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 3.5-preview / 3.0 |
| Default | ModelVersion=3.5-preview |
| Supported modes | Text generation, reference image generation, re-editing of generated output |
| Guardrail bypass support | Not supported |
The input and output guardrail bypass parameters do not apply to Hy Image.
It supports both text generation and reference-image-based generation.
3.0 accepts 3 reference images, and 3.5-preview accepts up to 6.
Request parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Hunyuan |
ModelVersion | Optional | String | 3.5-preview / 3.0 |
Prompt | Required | String | The generation prompt. When a reference image is present, it acts as the editing instruction |
FileInfos.N | Optional | Array | Reference images. Put Type and Url in it |
OutputConfig.Resolution | Optional | String | 1K / 2K / 4K |
OutputConfig.AspectRatio | Optional | String | 1:1 / 16:9 / 9:16 / 4:3, and so on |
OutputConfig.PersonGeneration | Optional | String | AllowAdult / Disallowed |
ExtInfo | Optional | String | Specifies the pixel size directly. See the entry below |
Output images per request
3.5-preview generates 1 image per request. For multiple images, submit requests sequentially.
Request examples โ
This is text generation.
{
"SubAppId": 123456789,
"ModelName": "Hunyuan",
"ModelVersion": "3.5-preview",
"Prompt": "a serene japanese garden, soft morning light",
"OutputConfig": {
"Resolution": "2K",
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}This is reference-image-based generation. When you put in a reference image, Prompt is interpreted as an editing instruction.
{
"SubAppId": 123456789,
"ModelName": "Hunyuan",
"ModelVersion": "3.5-preview",
"Prompt": "change the car color to matte black, keep the composition",
"FileInfos": [
{
"Type": "Url",
"Url": "https://<host>/car.png"
}
],
"OutputConfig": {
"Resolution": "1K",
"AspectRatio": "16:9",
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}Response example โ
{
"AigcImageTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "https://store.vod-qcloud.com/.../aigcImageGenFile.png",
"ExpireTime": "2026-10-02T07:59:41Z",
"MetaData": {
"Width": 2048,
"Height": 1152,
"Container": "png_pipe"
}
}
]
}
}
}Special settings โ
Output resolution โ
These are the actual output pixels for each combination of Resolution and AspectRatio. Values are aligned to multiples of 16.
| Resolution | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 |
|---|---|---|---|---|---|
| Omitted | 720x720 | 1280x720 | 720x1280 | 960x720 | 720x960 |
1K | 1024x1024 | 1808x1024 | 1024x1808 | 1360x1024 | 1024x1360 |
2K | 2048x2048 | 2048x1152 | 1152x2048 | 1920x1440 | 1440x1920 |
4K | 4096x4096 | 3840x2160 | 2160x3840 | 3840x2880 | 2880x3840 |
If you omit Resolution and pass only AspectRatio, the short side is fixed to 720. If you omit both values, the output is 1872x1248 at a 3:2 ratio. Even with the same Resolution, the actual pixels vary by ratio, so if you need an exact size, specify it directly with ExtInfo below.
The 4K / 5:4 combination is output as 2688x2160.
Specifying the pixel size directly โ
When you put size in ExtInfo, it takes precedence over Resolution and AspectRatio. The value is in widthxheight format.
{
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"size\\\":\\\"1808x1024\\\"}\"}"
}| Input value | Actual output |
|---|---|
1808x1024 | 1808x1024 |
656x1024 | 656x1024 |
656x1000 | 656x992 (rounded down to a multiple of 16) |
auto | Determined automatically from the prompt |
100x100 | 256x256 (corrected to the lower bound) |
The output size is corrected against multiples of 16 and the minimum size. When auto is specified together with Resolution, the ratio is determined based on that resolution; on its own, the ratio is determined from the prompt.
Reference images โ
Specify Type and Url in FileInfos. For image files, set Type to Url.
{
"FileInfos": [
{
"Type": "Url",
"Url": "https://<host>/reference.png"
}
]
}| Item | Value |
|---|---|
| Allowed fields | Type(Url), Url / ReferenceType (optional) |
| Number of references | Up to 6 |
| Formats | jpeg, png, webp |
Reference image fields
FileInfos specifies Type="Url" and the image Url.
Operational notes โ
| Item | Value |
|---|---|
1K processing time | 21 seconds at 12 seconds |
2K processing time | 30 seconds at 21 seconds |
4K processing time | 46 seconds at 34 seconds |
Multi-image requests are processed sequentially. Confirm Status="FINISH" / ErrCode=0 and Output.FileInfos in DescribeTaskDetail before submitting the next request.