Hy Image 3.5 Preview

使用 APIMaster API Key：Authorization: Bearer $APIMASTER_API_KEY，请求类型为 application/json。本页完整路径中的 /v1 已包含在 https://apimaster.ai/v1 中，例如 /v1/wand/... 对应 https://apimaster.ai/v1/wand/...。

网关先预留额度，收到上游实际用量后只结算一次，多余预留额度返还。余额不足时请求会在提交前拒绝。网络中断后请保留 request_id，避免盲目重发生成请求。

POST /v1/wand/hunyuan-image/v35-generation，Bearer API Key，JSON 请求。模型 hy-image-v3.5-preview。提供文生图、参考生图和多轮编辑。请求上下文上限 100k tokens。返回可能是连续 JSON 帧；须按实际 Content-Type 处理，不能假设响应为 OpenAI Images 的 data[].url。

参数	类型	必填	说明
model	string	是	hy-image-v3.5-preview
messages	object[]	是	按时间排序；最后一个 user 消息是本轮指令，其余为编辑上下文
size	string	否	宽x高；每边 256–8192，面积不超过 16,777,216；例如 4096x4096。空值由模型推断
seed	int64	否	0–2^63−1；0 或省略使用随机种子
generate_max_pixels	integer	否	不传 size 时生效；1,048,576 / 2,359,296（默认）/ 4,194,304；中间值归至最近档。4K 用 size
resize_max_pixels	integer	否	参考图超过该面积时等比缩小；默认 1,048,576
session	string	否	同一编辑会话保持一致，提高路由与 KV 缓存复用
footnote	string	否	右下角自定义水印，最多 16 个 Unicode 字符
use_search_tool	object	否	{"value":true} / {"value":false}，默认关闭

messages 元素：role 必填，取 user / assistant / tool；content 为数组，assistant 仅触发工具时可省略。assistant 可包含原样回传的 reasoning、tool_calls；tool 需传与前一条工具调用 ID 一致的 tool_call_id。tool_calls[] 使用 {id,type:"function",function:{name,arguments}}，其中 arguments 是 JSON 字符串。

content 元素：type=text 配 text；type=image_url 配 image_url:{url:...}。图片接受公网 URL 或带 MIME 前缀的 data URI；单图不超过 20MB，上下文最多 20 张，超出可能从较早轮次截断。tool 消息回灌已生成图片时使用 is_generate:true，普通参考图不传此字段。

{"model":"hy-image-v3.5-preview","size":"1024x1024","messages":[{"role":"user","content":[{"type":"text","text":"白底蓝色圆形，简洁构图"}]}]}

响应主图位于 choices[0].delta.image.url；image 另含 width、height、source、tool_call_id。顶层 id 是 trace ID，object 为 image.chat.completion.chunk，created 是 Unix 秒，round 为轮次，request_id 用于追踪。model 可能返回原厂内部版本号，不宜据此判断客户端请求的模型名称。finish_reason 可能为 null 且连接直接结束，必须结合图片 URL 判断成功；失败帧可能有 error:{type,code,message,request_id}。

usage.total_tokens 是原厂总量；tokenhub_usage.total_tokens 是网关计费总量。按实际返回的总量结算一次，不要重复加总两份 usage。assembled_history 是可原样追加至下一轮 messages 的完整上下文；其中工具中间图 URL 不等于最终交付图片 URL。结果 URL 有效期有限，应及时下载。

HTTP 400 检查字段；401 检查鉴权；422 是内容审核；429 退避控制并发；500 保留 request_id 排查。不能因未出现 finish_reason 就重复提交，避免重复付费。

官方目录价：每百万计费 tokens $1.6；1K/2K 每张 15,000 tokens（$0.024），4K 每张 20,000 tokens（$0.032）。核查日期 2026-11-11，实际用量以响应与账单为准。

来源：腾讯官方接口文档

官方参考价格

下表是腾讯国际站官方目录价（2026-11-11），APIMaster 当前售价请打开对应模型卡。媒体统一按上游实际计费 tokens 结算，每百万计费 tokens $1.60，不能将此单价理解为每张或每秒费用。

模型	规格	用量换算	目录参考价
hy-image-v3.5-preview	1K	每张折合 15000 tokens	0.024 USD/张
hy-image-v3.5-preview	2K	每张折合 15000 tokens	0.024 USD/张
hy-image-v3.5-preview	4K	每张折合 20000 tokens	0.032 USD/张

先注册，再在控制台创建密钥，按本页的具体模型 ID 调用 https://apimaster.ai/v1。