HY Image 3.5 Preview API

HY Image 3.5 Preview API 用于调用 HY Image 3.5 Preview——腾讯混元的图像生成与编辑模型，于 2026 年 9 月 22 日以托管预览版发布，一个模型同时支持文生图、参考图生成和图片编辑。在 APIMart 上传入模型 ID hy-image-v3.5-preview 即可调用。

HunyuanImage 3.0（混元图像 3.0）是腾讯此前发布的开源权重模型；HY Image 3.5 Preview 为托管模型，未公开权重，腾讯将其定位为在文字渲染、真实感和编辑一致性上的升级。

腾讯将本次发布标注为预览版，输出效果、限制和底层模型都可能调整。正式用于生产前，请先测试关键的 HY Image API 流程，并关注本页更新。

image_urls 最多传 5 张公网可访问的 JPEG、PNG 或 WebP 图片，单张建议小于 7MB。请在提示词中说明要保留、修改或融合哪些元素；不传 image_urls 时，hy-image-v3.5-preview 进行文生图。

size 可设为 auto（缺省），或 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9；resolution 可设为 1K（缺省）、2K 或 4K。需要精确尺寸时，向 hy-image-v3.5-preview 传 2000x1104 这类像素值，或成对传 width 和 height：单边 256–8192 像素，总像素不超过 8,294,400。

不能。HY Image 3.5 Preview 每次请求只返回一张图片，n 必须为 1；需要多个变体时请并行发送多个请求。

可以。把上一轮的结果作为参考图传回 hy-image-v3.5-preview，并附上新的修改指令即可，每一轮都是一次独立请求。

HY Image 3.5 Preview 按输出图片张数计费。传宽高比时按 resolution 档位收费；传精确像素时按短边定档：≤1024 为 1K，1025–2048 为 2K，更大为 4K。本页价格表实时展示各档价格，任务失败全额退款。

登录 APIMart 并充值积分后，在 API Keys 页面创建密钥，并在请求头 Authorization 中以 Bearer 方式传入。同一个 API Key 可用于所有 HY Image API 请求及 APIMart 上的其他模型。

以模型 hy-image-v3.5-preview 调用 POST /v1/images/generations 并保存返回的 task_id，然后每 3–5 秒轮询一次 GET /v1/tasks/{task_id}，建议最多等待约 5 分钟。状态为 completed 时读取 result.images[0].url[0]，并在 expires_at 之前下载图片。

是的，它们指的都是腾讯的同一个模型。图片接口中的模型 ID 是 hy-image-v3.5-preview；腾讯 Chat 文档写作 Hy-Image-3.5-Preview，评测网站则列为 HunyuanImage 3.5 (Preview)。HY-Image 3.5、Hy Image3.5、HY Image v3.5、Hunyuan Image 3.5 API 等写法也指同一模型。在 APIMart 上，请通过 HY Image API 传入 hy-image-v3.5-preview 调用。

你可以通过页面右下角的在线客服、发送邮件至 [email protected]，或在 Discord 社区中联系我们。我们的团队会尽快回复你的问题。