hunyuan-image-3 API
Hunyuan Image 3 已通过 API in One 接入真实生产路由 /api/v1/images/generations,后端节点为 node68。一个 API Key 即可调用并按成功请求计费。
请求体中的 model 字段。
当前已实现的 BFF 路由。
输入类型:text, image
密钥由共享 Dashboard 管理。
该路由不依赖 webhook。
服务亮点
用市场页形式展示真实已接入能力,不复用外部平台的 SLA、折扣或账号流程。
当前页面只展示已在 /api/v1 中实现的端点。 /api/v1/images/generations
该模型直接返回响应,不需要创建媒体任务。
充值、订单、积分余额和个人资料继续使用现有共享控制台与旧逻辑。
浏览器只持有 API in One Key,上游 Provider 调用由服务端处理。
调用契约
复制这些字段即可接入当前真实模型路由。
- Base URL
https://apiin.one客户端调用同源 API,服务端 BFF 转发到 Worker。- 鉴权
Authorization: Bearer <API_KEY>由现有 Dashboard API Keys 页面管理。- Model 字段
hunyuan-image-3放在请求体 model 字段中。- 结果查询
/api/v1/tasks/{task_id}异步任务返回 task_id 后查询。- 计费入口
/billing/credits使用现有积分、订单和充值旧逻辑。
运行方式
该模型创建异步任务,返回 task_id 后通过真实状态接口取回结果。
API Console
像模型市场一样直接切换同端点真实模型、端点和语言,右侧示例由当前 live catalog 的 payload 生成。
curl --request POST \
--url https://apiin.one/api/v1/images/generations \
--header 'Authorization: Bearer <API_KEY>'
--header 'Content-Type: application/json' \
--data-raw '{
"model": "hunyuan-image-3",
"prompt": "A traditional Chinese garden with cherry blossoms and a koi pond, watercolor style",
"type": "text-to-image",
"size": "1024*1024"
}'/api/v1/tasks/{task_id}端点评估
基于当前真实 endpoint 下的已上线模型,快速判断成本、供应商覆盖和生产接入方式。
按基础积分从低到高排序。
异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。
真实能力
以下能力来自当前已接入的模型配置和后端路由,不展示未上线 API。
稳定生产路由
Tencent's state-of-the-art image model
统一接口
Both text-to-image and image editing
透明计费
Seed-based reproducibility
快速接入
Instruction-following image generation
请求方式
浏览器端只调用同源 API,服务端 BFF 再转发到对应 Worker。
参数
promptstringText description of the image (max 2000 chars)
必填typestringGeneration type: "text-to-image" or "edit"
可选 · 默认 text-to-imagesizestringImage size (e.g. "1024*1024")
可选 · 默认 1024*1024imagesarrayArray of image URLs for edit mode (max 2, required when type is "edit")
可选seednumberRandom seed for reproducibility (-1 for random)
可选 · 默认 -1示例请求
curl -X POST https://apiin.one/api/v1/images/generations \
-H "Authorization: Bearer aio_your_api_key" \
-H "Content-Type: application/json" \
--data-raw '{
"model": "hunyuan-image-3",
"prompt": "A traditional Chinese garden with cherry blossoms and a koi pond, watercolor style",
"type": "text-to-image",
"size": "1024*1024"
}'同端点可切换模型
这些模型使用同一个已实现 BFF endpoint,可通过请求体中的 model 字段切换。
同端点模型对比
同一个真实路由下的模型差异,便于按成本、输入输出和后端节点选择。
node68🧠cogview-4Zhipu AI / WaveSpeed异步任务text -> image4 积分$0.04node48node41
grok-imaginexAI异步任务text -> image5 积分$0.05node31
kling-image-o1Kuaishou / WaveSpeed异步任务text + image -> image6 积分$0.06node49✦ideogram-v3Ideogram异步任务text + image -> image8 积分$0.08node63🌐imagen-4Google异步任务text -> image8 积分$0.08node47🤖gpt-image-1.5-officialOpenAI异步任务text + image -> image10 积分$0.10node42🎨recraft-v4Recraft异步任务text -> image10 积分$0.10node78✦ideogram-v4Ideogram异步任务text -> image12 积分$0.12node63node30接入流程
这些步骤基于当前真实路由和共享账号体系,不新增独立登录、支付或订单流程。
创建共享 API Key
在现有 Dashboard 创建密钥,充值、订单、积分和个人信息仍走共享控制台。
调用真实端点
使用当前页面列出的 endpoint、model id 和参数发送请求。 /api/v1/images/generations
查询任务状态
异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。
任务状态查询
图像、视频、音频和工具任务创建后,使用真实任务端点查询结果。
GET/api/v1/tasks/{task_id}查询生成任务状态和结果。价格
~$0.25 per image (25 credits)
使用场景
这些场景可通过当前模型和对应后端节点实现。
Generate high-fidelity images from text descriptions
Edit existing images with text instructions
Create product imagery with Tencent-grade quality
Build AI-powered image editing workflows
常见问题
How much does Hunyuan Image 3 cost?
Each image costs 25 credits (~$0.25) for both text-to-image and edit modes.
Does Hunyuan Image 3 support image editing?
Yes. Set type to "edit" and provide images (up to 2) alongside your text prompt for editing.
Does it support seed-based reproducibility?
Yes. Set the seed parameter to reproduce specific results.