> ## 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.5-preview

腾讯混元推出的新一代图像生成模型，从意图理解到视觉表达，全面提升面向应用场景的内容交付能力。模型大幅增强文字渲染与布局能力，可准确处理多语言、符号、小字元素与复杂排版关系，适合广告、信息图、UI 界面设计等文字密集场景；真实感与风格表现力进一步增强，真实世界光影与材质更细腻，覆盖电影感、漫画风、商业摄影、插画设计等多种视觉风格；编辑一致性更稳定，在更换场景、调整造型或转换风格时延续人物与商品的关键特征，局部修改精准遵循编辑要求，为影视后期、商品展示等专业制作提供可靠支持。

### 模型参数

* 模型ID：`hy-image-v3.5-preview`
* 模型价格：你可以在[模型详情页](https://geekai.co/models/hy-image-v3.5-preview)查看最新价格信息
* 调用入口：`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 中的以下参数：
>
> * `enhance_prompt`
> * `negative_prompt`
> * `strength`
> * `quality`
> * `aspect_ratio`
> * `style_preset`
> * `n`
> * `response_format`
> * `output_format`
> * `mask`
> * `background`
>
> 附：[Hy-Image-3.5-preview 官方 API 文档](https://cloud.tencent.com/document/product/1823/135745#619bf742-e297-460a-a0d1-cdb03db58491)

极客智坊遵循 OpenAI 生图接口，通过 `prompt` + `image` 替代官方的 `messages` 参数来传入提示词+单张/多张参考图片，参考图要求如下：

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

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

* 宽、高均为正整数，取值范围 \[256, 8192]；
* 宽 × 高（面积）不超过 16777216，即最高支持 4096×4096（4K）

不支持官方的 `generate_max_pixels` 和 `resize_max_pixels`，生图尺寸由 `size` 参数控制。

### 文生图

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

```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.5-preview",
    "prompt": "画一只可爱的小猫",
    "size": "2048x2048"
}'
```

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

```json theme={null}
{
    "model": "hy-image-v3.5-preview",
    "created": 1792639376,
    "task_id": "427a5079-767d-404c-84b2-504fbf16c1d1",
    "task_status": "succeed",
    "data": [
        {
            "url": "https://static.geekai.co/image/2026/10/22/bf1ad02ef6b9f1c9b6a391f0e4aef258.png"
        }
    ],
    "usage": {
        "total_tokens": 15000
    }
}
```

### 图生图

**单图**

通过 `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.5-preview",
    "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.5-preview",
    "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.