> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Hy-Image-3.0

最新混元 Image-3.0 生图模型。基于混元大模型，能够去思考图像的布局、构图、笔触，利用世界知识去推理常识性的画面。同时可以解析千字级别的复杂语义，生成长文本文字、复杂漫画、表情包，还能生成生动有趣的科普插画。

### 模型参数

* 模型ID：`hy-image-v3`
* 模型价格：你可以在[模型详情页](https://geekai.co/models/hy-image-v3)查看最新价格信息
* 调用入口：`https://geekai.co/api/v1/images/generations`
* 模型参数：参考[画图 API 手册](https://docs.geekai.co/cn/api/image/generations)
* API认证：[获取 API KEY](https://geekai.co/user/api_keys)

> [!NOTE]
>
> 不支持画图公共 API 中的以下参数：
>
> * `negative_prompt`
> * `strength`
> * `quality`
> * `aspect_ratio`
> * `style_preset`
> * `n`
> * `response_format`
> * `output_format`
> * `mask`
> * `background`
>
> 附：[Hy-Image-3.0 官方 API 文档](https://cloud.tencent.com/document/product/1823/135745#hy-image-3.0-.E5.9B.BE.E7.89.87.E7.94.9F.E6.88.90)

极客智坊通过 `image` 替代官方的 `images` 参数来传入单张或多张参考图片：

* 支持传入图片 URL 或 base64 编码，图片格式：png/jpeg/jpg
* 传入图片URL时需支持公网访问，国内版需使用国内可访问的 URL，否则请通过 base64 编码传递
* 单张图片大小不能超过10MB
* 最多支持3张参考图

支持通过 `size` 来控制生成图像的尺寸和分辨率，`size` 的取值范围:

* 宽、高均在 \[512, 2048] 像素范围内
* 宽、高乘积（图像面积）不超过 1024×1024 像素

极客智坊通过 `enhance_prompt` 替代官方的 `revise` 参数用于对生成图像的提示进行自动增强。

### 文生图

通过文字描述来生成对应图像：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"hy-image-v3",
    "prompt": "画一只可爱的小猫",
    "size": "1024x1024"
}'
```

响应是一个包含生成图片 URL 的 JSON 对象：

```json theme={null}
{
    "model": "hy-image-v3",
    "created": 1792638632,
    "task_id": "02dbbdd4-055a-4f74-998f-2cbdcbe832d6",
    "task_status": "succeed",
    "data": [
        {
            "url": "https://static.geekai.co/image/2026/10/22/11b0a2059702514cabf78acca4bf183f.png",
            "revised_prompt": "画一只可爱的小猫"
        }
    ],
    "usage": {
        "total_tokens": 20000
    }
}
```

### 图生图

**单图**

通过 `image` 参数传入参考图片来进行图生图操作：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"hy-image-v3",
    "prompt": "将图中女生的服装颜色变为绿色",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png"
}'
```

**多图**

通过 `image` 参数以数组方式传入多张参考图片即可：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"hy-image-v3",
    "prompt": "将图2女生的服装换为图1女生的服装",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png", 
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
    ]
}'
```

> [!NOTE]
>
> 对于耗时生图任务，可以通过设置 `async` 参数为 `true` 开启异步任务模式。异步任务模式下，画图接口会返回一个 `task_id`，你可以通过轮询 `https://geekai.co/api/v1/images/{task_id}` 来获取图像生成的最新状态，当任务完成后即可获得最终的图像URL，相关细节请参考[异步生图](https://docs.geekai.co/cn/docs/image/txt2img#异步生图)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.