文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>大模型服务平台 TokenHub>调用指南>图像生成

图像生成

最近更新时间：2026-04-03 16:27:22

我的收藏

本页目录：

概述

腾讯混元生图是一款提供 AI 图像生成与处理能力的 API 技术服务，可以结合输入的图片或文本智能创作出与输入相关的图像内容，具有更强大的中文理解能力、更多样化的风格选择，以及更偏东方审美的绘画创作能力，能更好地支持中文场景下的建筑风景生成、古诗词理解、水墨剪纸等中国元素风格生成，以及各种动漫、游戏风格的高精度图像生成和风格转换，为高质量的内容创作、内容运营提供技术支持。

产品功能

混元生图（3.0）

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

混元生图（极速版）

混元生图极速版（即 HY-Image-Lite），基于混元大模型，采用超高压缩编解码器，实现图像生成快速响应与高品质输出。支持电商商品图美化、设计工具素材生成、游戏场景迭代等场景。

立即使用

TokenHub 采用标准 OpenAI Chat Completions API 协议，您可以直接使用 OpenAI SDK 或任何兼容客户端接入。通过调用 API 对腾讯混元生图模型进行操作，例如 HY-Image-V3.0、HY-Image-Lite。
具体使用方式请参见对应接口文档：
模型
接口名称
接口文档
接口功能
HY-Image-Lite
混元文生图接口，基于混元大模型，根据输入的文本描述快速生成图片。
HY-Image-V3.0
混元生图接口，基于混元大模型，根据输入的文本/参考图描述智能生成图片。

OpenAI 兼容接口调用示例

混元生图（极速版）接口

混元生图（极速版） API 兼容了 OpenAI 的接口规范，这意味着您可以在 OpenAI 协议中使用 cURL 来调用混元生图大模型。您仅需要将 YOUR_API_KEY 替换成混元的相关配置，即可将应用切换到混元生图。
base_url：https://tokenhub.tencentmaas.com/v1/api/image/lite。
请求示例代码如下，其中：请求的具体参数与 混元生图（极速版） 接口一致，但参数统一以小写驼峰形式呈现，例如 LogoAdd 需要写为 logo_add。
cURL
curl --location 'https://tokenhub.tencentmaas.com/v1/api/image/lite'\\
--header 'Authorization: Bearer YOUR_API_KEY' \\
--header 'Content-Type: application/json' \\
--data '{
    "model": "hy-image-lite",
    "prompt": "雨中, 竹林,  小路",
    "rsp_img_type":"url"
}'
响应示例代码如下：
cURL
{
    "created": 1774806537,
    "request_id": "ce************c3",
    "data": [
        {
            "url": "https://hyimg*************9c81de85"
        }
    ]
}

混元生图（3.0）接口

提交混元生图（3.0）任务
混元生图（3.0） API 兼容了 OpenAI 的接口规范，这意味着您可以在 OpenAI 协议中使用 cURL 来调用混元生图大模型。您仅需要将 YOUR_API_KEY 替换成混元的相关配置，即可将您的应用切换到混元生图。
base_url：https://tokenhub.tencentmaas.com/v1/api/image/submit。
请求示例代码如下，其中：请求的具体的参数与 提交混元生图（3.0）任务 一致，但参数统一以小写驼峰形式呈现，如 LogoAdd 需要写为 logo_add。
说明：
images 可以为任意可访问的图片地址。
cURL
curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/image/submit' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
    "model": "hy-image-v3.0",
    "prompt": "在图片中增加一个橘猫",
    "images": [
        "https://***************.jpeg"
    ]
}'
返回结果示例代码如下：
cURL
{
    "id": "251*************0",
    "request_id": "96**********1d4",
    "object": "image_job",
    "created_at": 1774806585,
    "status": "queued"
}
查询混元生图（3.0）任务
将 YOUR_API_KEY 替换成混元的相关配置，发送查询相关请求，即可获取混元生图（3.0）的图片生成结果。其中：id 为提交混元生图（3.0）任务时响应代码中的 id。
base_url：https://tokenhub.tencentmaas.com/v1/api/image/query 。
请求示例代码如下，其中：请求的具体的参数与 查询混元生图（3.0）任务 一致，但参数统一以小写驼峰形式呈现。
cURL
curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/image/query' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
  	"model": "hy-image-v3.0",
    "id":"251*************0"
}'
返回结果示例代码如下：
cURL
{
    "request_id": "5785*****da7f2af",
    "object": "image_job",
    "created_at": 1774806639,
    "completed_at": 1774806639,
    "status": "completed",
    "data": [
        {
            "url": "https://****965e",
            "revised_prompt": "\\u003cthink\\u003e用户希望在图片中增加一******纹理。\\u003c/recaption\\u003e\\u003canswer\\u003e\\u003cboi\\u003e\\u003cimg_size_1024\\u003e\\u003cimg_ratio_34\\u003e"
        }
    ]
}

中国站