Skip to content
English
Esc
↑↓navigate↵open⌘Jpreview
On this page

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.