What is the HY Image 3.5 Preview API?

The HY Image 3.5 Preview API gives you HY Image 3.5 Preview, Tencent Hunyuan's image generation and editing model released as a hosted preview on September 22, 2026. One model covers text-to-image, reference-based generation and editing. On APIMart, send the model ID hy-image-v3.5-preview.

How is HY Image 3.5 Preview different from Hunyuan Image 3.0?

HunyuanImage 3.0 is Tencent's earlier open-weight model. HY Image 3.5 Preview is a hosted model with no published weights, and Tencent presents it as an upgrade in text rendering, realism and edit consistency.

What does Preview mean in HY Image 3.5 Preview?

Tencent labels this release a preview, so output quality, limits and the underlying model may change. Test important HY Image API workflows before production use and check this page for updates.

How many reference images does the HY Image 3.5 Preview API accept?

Send hy-image-v3.5-preview up to five publicly accessible JPEG, PNG or WebP URLs in image_urls, ideally under 7 MB each. Describe in the prompt which elements to keep, change or combine. Leave image_urls out for text-to-image.

Which sizes does the HY Image 3.5 Preview API support?

Set size to auto (default) or 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 or 21:9, and resolution to 1K (default), 2K or 4K. For an exact hy-image-v3.5-preview size, pass size such as 2000x1104 or a width and height pair: 256–8192 px per side, at most 8,294,400 pixels.

Can I generate several images per call?

No. Each HY Image 3.5 Preview request returns one image, so n must be 1. Send parallel requests when you need several variations.

Can I edit an image over several rounds with HY Image 3.5 Preview?

Yes. Pass the previous result back to hy-image-v3.5-preview as a reference image together with a new instruction. Each round is a separate request.

How much does the HY Image 3.5 Preview API cost?

HY Image 3.5 Preview bills each output image once, whatever you pass to hy-image-v3.5-preview. With an aspect ratio, the resolution tier sets the rate; with exact pixels, the short edge decides: up to 1024 px is 1K, 1025–2048 px is 2K, larger is 4K. The pricing table shows live rates, and failed tasks are fully refunded.

How do I get an HY Image 3.5 Preview API key?

Sign in to APIMart, add credits and create a key on the API Keys page. Send it as a Bearer token in the Authorization header; the same API key works for every HY Image API request and every other model on APIMart.

How do I receive images from the HY Image 3.5 Preview API?

Submit to POST /v1/images/generations with model hy-image-v3.5-preview and keep the task_id, then poll GET /v1/tasks/{task_id} every 3–5 seconds for up to about 5 minutes. When the status is completed, read result.images[0].url[0] and download the image before expires_at.

Is HY Image 3.5 Preview the same as HY Image 3.5 or Hunyuan Image 3.5?

Yes, they all refer to the same Tencent model. Its model ID on the images endpoint is hy-image-v3.5-preview; Tencent's chat documentation writes Hy-Image-3.5-Preview, and benchmark sites list HunyuanImage 3.5 (Preview). Spellings such as HY-Image 3.5, Hy Image3.5, HY Image v3.5 or Hunyuan Image 3.5 API point to the same model. On APIMart, call it through the HY Image API with hy-image-v3.5-preview.

Back to models

Image

HY Image 3.5 Preview API

HY Image 3.5 Preview API access to Tencent Hunyuan's latest image model: text-to-image, reference-based editing and multi-image composition, with strong multilingual text rendering and 1K, 2K, 4K or exact-pixel output.

Text to ImageImage EditingUp to 5 References1K / 2K / 4KText Rendering

Get API Key API Docs

Service Highlights

Official Discounts
Pay-as-you-go
Fast & Low Latency

Input

Model

Reference Image

Prompt

Aspect Ratio

Resolution

Negative Prompt

Seed

Output

Image link valid for 72 hours

HY Image 3.5 Preview API Pricing

Transparent pricing with no hidden fees. Pay only for what you use.

Variant	Tier	GoldCurrent price	Platinum	Diamond	Official	Your savings
`hy-image-v3.5-preview`	1K	0.192Credits(~$0.0192)/pic	0.1824Credits(~$0.0182)/pic	0.1728Credits(~$0.0173)/pic	0.24Credits(~$0.024)/pic	20%