HY Image 3.5 Preview
Tencent Hunyuan's preview image model for text-to-image and editing with up to five references, up to 4K
| Model ID | Aliases | Endpoint |
|---|---|---|
tencent/hy-image-3.5-preview |
hy-image-v3.5-preview, hy-image-3.5-preview |
Image generation |
Input modes
| Mode | References | Reference roles |
|---|---|---|
text Text only |
— | — |
image Image input |
1 to 5 | reference_image |
Parameters
| Parameter | Description | Values | Default | Required |
|---|---|---|---|---|
resolution |
Resolution: Output resolution. | 1K, 2K, 4K |
1K |
No |
aspect_ratio |
Aspect ratio: Output aspect ratio. Only in text. |
1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 5:4, 4:5, 21:9 |
1:1 |
No |
aspect_ratio |
Aspect ratio: Output aspect ratio. Only in image. |
auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 5:4, 4:5, 21:9 |
auto |
No |
n |
Outputs per request: Number of outputs from one API request (one Job), not the application batch size. For multiple Jobs, submit separate requests; n=1 does not prevent application-managed batching. | 1 |
1 |
No |
Examples
text input:
{
"model": "tencent/hy-image-3.5-preview",
"input": {
"type": "text",
"prompt": "A watercolor fox reading a map in a pine forest"
},
"parameters": {
"resolution": "1K",
"aspect_ratio": "1:1",
"n": 1
}
}
image input:
{
"model": "tencent/hy-image-3.5-preview",
"input": {
"type": "image",
"prompt": "A watercolor fox reading a map in a pine forest",
"references": [
{
"role": "reference_image",
"file_id": "file_..."
}
]
},
"parameters": {
"resolution": "1K",
"aspect_ratio": "auto",
"n": 1
}
}
The authoritative contract is GET /v1/models/tencent/hy-image-3.5-preview?view=contract. A valid parameter does not mean every channel can run it, so quote the complete request. Prices and channels are listed in Model Market.