🏔️图像 API已上线

hunyuan-image-3 API

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

获取 API Key 查看文档

Model IDhunyuan-image-3

请求体中的 model 字段。

端点/api/v1/images/generations

当前已实现的 BFF 路由。

输出image

输入类型：text, image

鉴权Bearer API Key

密钥由共享 Dashboard 管理。

Webhook不需要

该路由不依赖 webhook。

真实能力

以下能力来自当前已接入的模型配置和后端路由，不展示未上线 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。

方法端点积分用途

POST/api/v1/images/generations25 积分

Hunyuan Image 3 Instruct — Tencent's advanced text-to-image and image editing model. 25 credits per image with seed-based reproducibility.

参数

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

🧠cogview-4image · 4 积分/api/v1/images/generations

flux-2image · 5 积分/api/v1/images/generations

grok-imagineimage · 5 积分/api/v1/images/generations

kling-image-o1image · 6 积分/api/v1/images/generations✦ideogram-v3image · 8 积分/api/v1/images/generations🌐imagen-4image · 8 积分/api/v1/images/generations

接入流程

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

创建共享 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)

基础价格$0.25

积分25

计费按成功请求

使用场景

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

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.