🏔️图像 API已上线

hunyuan-image-3 API

Hunyuan Image 3 已通过 API in One 接入真实生产路由 /api/v1/images/generations,后端节点为 node68。一个 API Key 即可调用并按成功请求计费。

真实路由数1当前模型关联的真实端点行。
同端点模型11共享该 endpoint 的已上线模型。
基础成本25 积分$0.25 · 5–15 seconds
端点族图像 API/api/v1/images/generations
Model IDhunyuan-image-3

请求体中的 model 字段。

端点/api/v1/images/generations

当前已实现的 BFF 路由。

输出image

输入类型:text, image

鉴权Bearer API Key

密钥由共享 Dashboard 管理。

Webhook不需要

该路由不依赖 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 后通过真实状态接口取回结果。

Client request/api/v1/images/generationstask_id → result
查看使用日志

API Console

像模型市场一样直接切换同端点真实模型、端点和语言,右侧示例由当前 live catalog 的 payload 生成。

真实模型11 个已上线模型
端点1 路由
供应商Tencent / WaveSpeedhttps://n68.gogloai.com
当前成本25 积分 · $0.25~$0.25 per image (25 credits)
运行方式异步任务异步任务返回 task_id 后查询。
输入 / 输出text + image -> image该模型直接返回响应,不需要创建媒体任务。
后端节点node68浏览器只持有 API in One Key,上游 Provider 调用由服务端处理。
请求预览POST /api/v1/images/generations
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 下的已上线模型,快速判断成本、供应商覆盖和生产接入方式。

同端点模型11使用同一个 BFF 路由,可通过 model 字段切换。
供应商覆盖10当前 endpoint 下的真实供应商来源。
成本区间4-25 积分$0.04-$0.25 · 按当前 live catalog 的基础积分估算。
Webhook 覆盖5/11支持 callback_url 的模型数量。
当前模型位置11/11

按基础积分从低到高排序。

当前 endpoint 低成本模型cogview-4

Zhipu AI / WaveSpeed · 4 积分 · $0.04

生产接入方式异步任务 + 状态查询

异步媒体和工具任务使用 /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。

参数

promptstring

Text description of the image (max 2000 chars)

必填
typestring

Generation type: "text-to-image" or "edit"

可选 · 默认 text-to-image
sizestring

Image size (e.g. "1024*1024")

可选 · 默认 1024*1024
imagesarray

Array of image URLs for edit mode (max 2, required when type is "edit")

可选
seednumber

Random 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 字段切换。

同端点模型对比

同一个真实路由下的模型差异,便于按成本、输入输出和后端节点选择。

接入流程

这些步骤基于当前真实路由和共享账号体系,不新增独立登录、支付或订单流程。

01

创建共享 API Key

在现有 Dashboard 创建密钥,充值、订单、积分和个人信息仍走共享控制台。

02

调用真实端点

使用当前页面列出的 endpoint、model id 和参数发送请求。 /api/v1/images/generations

03

查询任务状态

异步媒体和工具任务使用 /api/v1/tasks/{task_id} 查询结果;对话模型直接返回响应。

任务状态查询

图像、视频、音频和工具任务创建后,使用真实任务端点查询结果。

GET/api/v1/tasks/{task_id}查询生成任务状态和结果。

价格

~$0.25 per image (25 credits)

基础价格$0.25
积分25
计费按成功请求

使用场景

这些场景可通过当前模型和对应后端节点实现。

01

Generate high-fidelity images from text descriptions

02

Edit existing images with text instructions

03

Create product imagery with Tencent-grade quality

04

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.

相关真实模型