🏔️Image APIActive

hunyuan-image-3 API

Generate and edit images with Tencent's Hunyuan Image 3 Instruct via API in One. Text-to-image and image editing. 25 credits per image (~$0.25).

Real routes1Real endpoint rows linked to this model.
Endpoint models11Live models sharing this endpoint.
Base cost25 credits$0.25 · 5–15 seconds
Endpoint familyImage API/api/v1/images/generations
Model IDhunyuan-image-3

Use this in the request body model field.

Endpoint/api/v1/images/generations

The currently implemented BFF route.

Outputimage

Input types: text, image

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookNot required

This route does not require webhook handling.

Service highlights

Marketplace-style signals backed by the current live route, without copying external SLA, discount, login, or payment claims.

Live production route

This page only shows endpoints implemented under /api/v1. /api/v1/images/generations

Synchronous response

This model returns directly without creating a media task.

Shared billing system

Top-up, orders, credit balance, and profile continue through the existing shared console.

Managed provider credentials

Your browser only holds an API in One key; provider calls stay server-side.

Call contract

Use these fields to integrate the current live model route.

Base URL
https://apiin.one
Clients call same-origin APIs; the server BFF forwards to the Worker.
Authorization
Authorization: Bearer <API_KEY>
Managed by the existing Dashboard API Keys page.
Model field
hunyuan-image-3
Send this value in the request body model field.
Result path
/api/v1/tasks/{task_id}
Async jobs return task_id, then use status polling.
Billing path
/billing/credits
Uses the existing credits, orders, and top-up logic.

Runtime behavior

This model creates an async task, returns a task_id, then resolves through the real status route.

Client request/api/v1/images/generationstask_id -> result
View usage logs

API Console

Switch between real models on this endpoint, choose a live route, and generate request examples from the current catalog payload.

Live model11 live models
Endpoint1 Routes
ProviderTencent / WaveSpeedhttps://n68.gogloai.com
Current cost25 credits · $0.25~$0.25 per image (25 credits)
RuntimeAsync taskAsync jobs return task_id, then use status polling.
Input / outputtext + image -> imageThis model returns directly without creating a media task.
Backend nodenode68Your browser only holds an API in One key; provider calls stay server-side.
Request previewPOST /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"
}'
Result path/api/v1/tasks/{task_id}
Open docs

Endpoint decision panel

Evaluate cost, provider coverage, and production integration behavior across live models on this implemented endpoint.

Endpoint models11These models share the same BFF route and switch through the model field.
Provider coverage10Real provider sources currently exposed by this endpoint.
Cost range4-25 credits$0.04-$0.25 · Based on the current live catalog base credit cost.
Webhook coverage5/11Models on this endpoint that support callback_url.
Current model position11/11

Sorted by base credits from low to high.

Lowest-cost route in this endpointcogview-4

Zhipu AI / WaveSpeed · 4 credits · $0.04

Production patternAsync task + status polling

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

Live capabilities

These capabilities come from the current model config and backend route. Unreleased APIs are not listed.

Tencent's state

Tencent's state-of-the-art image model

Both text

Both text-to-image and image editing

Seed

Seed-based reproducibility

Instruction

Instruction-following image generation

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

Parameters

promptstring

Text description of the image (max 2000 chars)

Required
typestring

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

Optional · Default text-to-image
sizestring

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

Optional · Default 1024*1024
imagesarray

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

Optional
seednumber

Random seed for reproducibility (-1 for random)

Optional · Default -1

Example request

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"
}'

Models on the same endpoint

These live models use the same implemented BFF endpoint and can be switched by changing the model field.

Endpoint model comparison

Compare real models behind this implemented route by cost, provider, runtime mode, input, output, and backend node.

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

01

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

02

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/generations

03

Poll task status

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

Task status route

After creating image, video, audio, or tool tasks, poll the real task endpoint for results.

GET/api/v1/tasks/{task_id}Check generation task status and result.

Pricing

~$0.25 per image (25 credits)

Base cost$0.25
Credits25
BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

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

FAQ

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.

Related live models