Hunyuan Image

Parameters below were verified against the live model directory on November 5, 2026. Check the model directory for current schema, availability, and prices.

Overview

Hy-Image-3.5-preview (Hy Image 3.5 preview) is Tencent Hunyuan’s cost-effective, professional-grade image generation and editing model, officially released on September 22, 2026. It continues the Hy Image 3.0 design lineage with a systematic upgrade “from intent understanding to visual expression.” It supports text-to-image, image-to-image, and multi-turn conversational editing: a Chat/Messages structure receives text and reference images together, retains context across turns, and lets you keep refining subjects, scenes, and composition via natural language after generating — no restarting from scratch. In Tencent’s internal GSB blind test with several hundred professional designers, its overall win rate exceeded Hy Image 3.0 by roughly 30%, level with Seedream 5.0 Pro and slightly ahead of Nano Banana Pro and Qwen-Image-3.0 Pro (vendor’s own evaluation).

The full model guide, live parameter schema, and playground for every model ID are available in the HiPix model directory.

Model IDs

Model ID	Mode	Notes
`hy-image-3.5-preview-global`	Text-to-Image, Image-to-Image

Parameters

Requests are submitted to POST /v1/videos (video) or POST /v1/images/generations / POST /v1/images/edits (image). Fields marked metadata.* travel inside the metadata object.

`hy-image-3.5-preview-global`

API field	Type	Required	Values / limit
`prompt`	string	Yes	—
`image`	array	No	up to 9; ≤30 MB each; images
`size`	enum	Yes	`1080x1080`, `1080x1620`, `1620x1080`, `1080x1440`, `1440x1080`, `1080x1920`, `1920x1080`, `1512x648`, `2160x2160`, `1440x2160`, `2160x1440`, `2160x2880`, `2880x2160`, `1440x2560`, `2560x1440`, `2520x1080`, `4096x4096`, `3328x4992`, `4992x3328`, `3584x4800`, `4800x3584`, `2160x3840`, `3840x2160`, `5040x2160`; default `2560x1440`

Example

A minimal request for hy-image-3.5-preview-global:

curl -X POST https://api.apimart.cc/v1/images/generations \
  -H "Authorization: Bearer $HIPIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "hy-image-3.5-preview-global", "prompt": "A kitten running through a sunlit garden", "size": "2560x1440"}'

Limits, availability, and pricing

Submit only the input types listed for the exact model ID; unsupported inputs are rejected or removed on HiPix.
See Submit a Video Task or the model directory for the full request contract, and Pricing & Billing for how charges are settled.
Prices and availability are shown per model ID in the model directory.