> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# Hunyuan Image 3

> Open-source text-to-image model on a multimodal Mixture-of-Experts architecture with photorealistic detail and strong multilingual text rendering.

![Hunyuan Image 3](https://media.empiriolabs.ai/model-logos/hunyuan-image-3.png)

[Tencent](/providers/tencent) · Image Generation

`POST /v1/images/generations`

Open-source text-to-image model on a multimodal Mixture-of-Experts architecture with photorealistic detail and strong multilingual text rendering.

## At a glance

| Field               | Value                         |
| ------------------- | ----------------------------- |
| Model id            | `hunyuan-image-3`             |
| Model release date  | 2025-09-28                    |
| Input modalities    | Text                          |
| Output modalities   | Image                         |
| Context window      | -                             |
| Weight precision    | -                             |
| Features            | photorealistic, multilingual  |
| Native inference    | No                            |
| New                 | No                            |
| Supported endpoints | `POST /v1/images/generations` |
| Alternate model ids | `tencent/hunyuan-image-3`     |

## Pricing

| Charge   | Spec      | Rate   |
| -------- | --------- | ------ |
| Standard | per image | \$0.13 |

## Example request

```bash
curl https://api.empiriolabs.ai/v1/images/generations \
  -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model": "hunyuan-image-3", "prompt": "a misty forest at dawn", "size": "1024x1024"}'
```

## Parameters

| Parameter         | Type    | Required | Default | Description                                                                                                                                                                |
| ----------------- | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`          | string  | yes      | -       | Text prompt. Longer, specific prompts with layout and text details work well.                                                                                              |
| `aspect_ratio`    | enum    | no       | `"1:1"` | Output aspect ratio. The model renders about one megapixel at the chosen ratio. · Allowed: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `5:4`, `4:5`, `21:9`, `9:21` |
| `num_images`      | integer | no       | `1`     | Number of images to generate. Each is billed separately. · Range: 1 – 4                                                                                                    |
| `seed`            | number  | no       | -       | Reproducibility seed. Leave empty for random.                                                                                                                              |
| `response_format` | enum    | no       | `"url"` | Return signed URLs or base64 image data. · Allowed: `url`, `b64_json`                                                                                                      |

## Notes

Text-to-image at about one megapixel with a selectable aspect ratio.

**Content safety**

* Generated images pass an automated content-safety check. An image flagged as explicit is not returned. Because the image is generated before the check runs, a flagged generation is still billed.

---

*Machine-readable schema:* `GET https://api.empiriolabs.ai/v1/models/hunyuan-image-3`.