腾讯云大模型图像创作引擎（又称混元生图）是腾讯云推出的一款AI图像生成与处理API技术服务，以腾讯自研混元大模型为算法内核，结合自然语言处理（NLP）与计算机视觉（CV）技术，能够根据输入的文本或图片智能创作相关图像内容。该产品支持文本生成图像、图像到图像风格转换、局部修补与替换、AI写真、线稿生图、模特换装、商品背景生成等丰富的图像生成原子能力。与市面上其他AI绘画工具相比，混元生图在中文理解能力上具有显著优势，能更好地支持古诗词意境、水墨剪纸等中国元素风格的生成。

本文将从零开始，全面讲解腾讯云大模型图像创作引擎的对接使用方法，涵盖服务开通、多种对接方式、核心接口调用、参数调优、异步任务处理等核心内容，并提供完整的代码示例，帮助开发者快速上手。

需要先登录腾讯云控制台，点击：

1.1 注册腾讯云账号并完成实名认证

使用腾讯云大模型图像创作引擎服务的第一步是注册腾讯云账号。访问腾讯云官网，点击注册按钮，按照指引填写手机号、邮箱等信息完成账号注册。注册完成后，需要进行实名认证，这是调用腾讯云API接口的必要条件。

1.2 开通大模型图像创作引擎服务

完成账号注册和实名认证后，即可开通服务。需要特别注意的是，腾讯混元大模型相关功能正在逐步迁移至TokenHub平台。原混元生图控制台将不再新增模型能力并停止支持新购模型服务，用户已购买的模型服务可继续使用暂不受影响。如需开通新的模型服务或使用更多模型能力，建议直接前往TokenHub控制台进行开通。

在TokenHub控制台中，阅读并同意服务条款后单击立即开通，即可获得腾讯混元生图的API接口调用权限。首次开通服务后，系统会发放一定次数的免费调用额度供测试体验。

调用混元生图API需要一对密钥：SecretId和SecretKey，用于身份认证。在腾讯云控制台的访问管理-API密钥管理页面可以创建和查看密钥。需要特别注意，自2023年11月30日起，腾讯云对所有主账号和子账号的密钥关闭了查询SecretKey的功能，仅支持在创建时查看，因此创建后务必及时保存。如果忘记了SecretKey，只能删除旧密钥后重新创建。

对于子账号调用，需要主账号进行授权。主账号登录后在用户列表中找到对应的子账户，选择授权并关联策略，搜索并选择QcloudAIARTFullAccess策略即可完成授权。

腾讯云大模型图像创作引擎提供了丰富的API接口，主要分为同步接口和异步接口两大类。

同步接口在请求发出后直接返回结果，适用于对实时性要求较高的场景。主要同步接口包括：

异步接口采用"提交任务-查询结果"的两步模式，适用于处理时间较长的复杂任务。主要异步接口包括：

混元生图还支持多轮对话生图能力，通过多轮对话不断调整图像内容。分为提交任务和查询任务两个接口，提交任务时输入文本和前置对话ID，查询任务可获得在上一轮对话基础上继续生成的图像结果。

API Explorer是腾讯云提供的在线API调试工具，提供了在线调用、签名验证、SDK代码生成和快速检索接口等能力。对于开发者来说，这是上手最快的方式。

登录腾讯云控制台后，进入API Explorer页面。在页面中选择产品为"aiart"，版本选择"2022-12-29"。然后选择对应的接口，如TextToImageLite（极速版）或TextToImageRapid（2.0版）。

以文生图轻量版（TextToImageLite）为例：

API Explorer还提供了CLI示例标签，可以直接复制可用的命令行指令。页面中切换到CLI示例标签，就能直接复制可用的命令行指令。

腾讯云为开发者提供了多种语言的SDK，包括Python、Java、PHP、Go、NodeJS、.Net等。通过SDK调用API可以大大简化开发工作，无需手动处理签名和HTTP请求细节。

pip install tencentcloud-sdk-python-common
pip install tencentcloud-sdk-python-aiart

以下是使用Python SDK调用文生图轻量版接口的完整示例：

import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.aiart.v20221229 import aiart_client, models

# 实例化认证对象
cred = credential.Credential("您的SecretId", "您的SecretKey")

# 实例化HTTP选项
httpProfile = HttpProfile()
httpProfile.endpoint = "aiart.tencentcloudapi.com"

# 实例化客户端配置
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile

# 实例化客户端
client = aiart_client.AiartClient(cred, "ap-beijing", clientProfile)

# 实例化请求对象
req = models.TextToImageLiteRequest()
params = {
    "Prompt": "一只圆润可爱的橘猫，大眼睛，短腿，坐在窗台上，阳光洒落，水彩风格",
    "Style": "000",  # 不限定风格，通过Prompt描述风格
    "Resolution": "1024:1024"
}
req.from_json_string(json.dumps(params))

# 发起请求
resp = client.TextToImageLite(req)

# 输出结果
print(resp.to_json_string())

返回结果中包含生成的图片URL，可直接访问下载。需要注意的是，图片URL为临时链接，需要及时保存。

<dependency>
    <groupId>com.tencentcloudapi</groupId>
    <artifactId>tencentcloud-sdk-java-aiart</artifactId>
    <version>3.1.1350</version>
</dependency>

import com.tencentcloudapi.aiart.v20221229.AiartClient;
import com.tencentcloudapi.aiart.v20221229.models.TextToImageLiteRequest;
import com.tencentcloudapi.aiart.v20221229.models.TextToImageLiteResponse;
import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.common.exception.TencentCloudSDKException;

public class TextToImageLiteDemo {
    public static void main(String[] args) {
        try {
            // 实例化认证对象
            Credential cred = new Credential("您的SecretId", "您的SecretKey");
            
            // 实例化客户端
            AiartClient client = new AiartClient(cred, "ap-beijing");
            
            // 实例化请求对象
            TextToImageLiteRequest req = new TextToImageLiteRequest();
            req.setPrompt("一座古老的东方寺庙，清晨薄雾，水墨画风格");
            req.setStyle("000");
            req.setResolution("1024:1024");
            
            // 发起请求
            TextToImageLiteResponse resp = client.TextToImageLite(req);
            
            // 输出结果
            System.out.println(TextToImageLiteResponse.toJsonString(resp));
        } catch (TencentCloudSDKException e) {
            e.printStackTrace();
        }
    }
}

对于AI写真等复杂任务，需要使用异步接口。以下是Python SDK调用异步接口的示例：

import json
import time
from tencentcloud.common import credential
from tencentcloud.aiart.v20221229 import aiart_client, models

cred = credential.Credential("您的SecretId", "您的SecretKey")
client = aiart_client.AiartClient(cred, "ap-beijing")

# 第一步：提交任务
submit_req = models.SubmitHunyuanImageJobRequest()
params = {
    "Prompt": "一个穿着汉服的少女在樱花树下读书",
    "Resolution": "1024:1024"
}
submit_req.from_json_string(json.dumps(params))
submit_resp = client.SubmitHunyuanImageJob(submit_req)
job_id = submit_resp.JobId
print(f"任务已提交，JobId: {job_id}")

# 第二步：轮询查询任务结果
query_req = models.QueryHunyuanImageJobRequest()
query_req.JobId = job_id

while True:
    query_resp = client.QueryHunyuanImageJob(query_req)
    status = query_resp.JobStatus
    if status == "SUCCESS":
        print(f"生成成功，图片URL: {query_resp.ResultImage}")
        break
    elif status == "FAIL":
        print(f"生成失败: {query_resp.JobErrorMsg}")
        break
    else:
        print("任务处理中，等待5秒...")
        time.sleep(5)

TokenHub是腾讯云统一的AI大模型服务平台，聚合了腾讯混元、优图以及DeepSeek、GLM、Kimi、MiniMax等多种模型。TokenHub采用标准的OpenAI Chat Completions API协议，开发者可以直接使用OpenAI SDK或任何兼容客户端接入。

由于TokenHub兼容OpenAI协议，可以使用OpenAI SDK直接调用混元生图模型。仅需将base_url和api_key替换成混元的相关配置，即可无缝将应用切换到混元生图。

from openai import OpenAI

client = OpenAI(
    api_key="您的TokenHub API Key",
    base_url="https://api.tokenhub.tencentcloud.com/v1"
)

response = client.images.generate(
    model="HY-Image-V3.0",
    prompt="一只圆润可爱的橘猫，大眼睛，短腿，坐在窗台上，水彩风格",
    n=1,
    size="1024x1024"
)

print(response.data[0].url)

TokenHub支持的图像生成模型包括HY-Image-V3.0、HY-Image-Lite等。开发者可以在TokenHub控制台的视觉模型页面选择对应的生图模型。

提示词（Prompt）的质量直接影响生成图像的效果。优质的提示词能显著提升生图质量。以下是一些经过验证的提示词编写技巧：

建议采用"主体描述+风格指定+细节补充"的结构：

文生图轻量版接口提供了丰富的预置风格列表，可以直接选择预置风格，无需手动在Prompt中添加风格描述。如果希望自定义更多风格，可以在风格参数Style中传"000"（不限定风格），并在Prompt中输入"xx风格+其他提示词"。

大模型图像创作引擎支持预付费和后付费两种模式。结算顺序为：赠送的免费资源包 > 购买的预付费资源包 > 后付费。按量计费模式下，按接口用量（生成图片张数）计费，包括直接调用API和在控制台创作。调用接口失败不计费。批量生成按实际生成张数计费。

不同模型对应不同的单价。HY-Image-V3.0单张约0.2元，HY-Image-Lite单张约0.099元。V3.0在生成前需要做更多版面与语义层面的思考，推理过程更长；Lite通过压缩编解码器把单次生成的算力开销降下来。

SecretKey仅在创建时可见，务必及时保存。建议使用子账号而非主账号密钥进行调用，按照最小权限原则授权。

部分接口有频率限制，如QueryHunyuanImageJob接口限制为20次/秒。异步任务默认提供0个并发，代表最多能同时处理1个已提交的任务。

接口返回的图片URL为临时链接，有效时间通常为30分钟，需要及时下载保存。

腾讯混元大模型相关功能正逐步迁移至TokenHub平台。建议新用户直接通过TokenHub开通服务。

问1：腾讯云大模型图像创作引擎和混元生图是什么关系？

答：大模型图像创作引擎是腾讯云AI图像生成与处理API服务的官方产品名称，混元生图是该产品的通俗称呼。两者指的是同一个服务，以腾讯自研混元大模型为算法内核。

问2：我应该使用哪个入口开通服务？

答：由于原混元生图控制台正在逐步迁移下线，建议新用户直接前往TokenHub控制台开通服务。已开通的用户可继续使用原有服务不受影响。

问3：同步接口和异步接口有什么区别？

答：同步接口在请求发出后直接返回结果，适合文生图轻量版等快速场景。异步接口采用"提交任务-查询结果"的两步模式，适用于AI写真等复杂任务。

问4：如何使用OpenAI SDK调用混元生图？

答：TokenHub平台兼容OpenAI协议，仅需将base_url和api_key替换成混元的相关配置即可。示例代码中base_url设置为https://api.tokenhub.tencentcloud.com/v1。

答：建议采取以下策略：高频场景选择HY-Image-Lite模型；购买预付费资源包享受更低单价；充分利用首次开通的免费额度；批量生成按实际张数计费。

问6：生成的图片链接有效期是多久？

答：接口返回的图片URL通常为30分钟临时链接，需要在有效期内及时下载保存。建议在获取到图片URL后立即执行下载操作。

腾讯云大模型图像创作引擎对接使用完全指南

腾讯云大模型图像创作引擎（又称混元生图）是腾讯云推出的一款AI图像生成与处理API技术服务，以腾讯自研混元大模型为算法内核，结合自然语言处理（NLP）与计算机视觉（CV）技术，能够根据输入的文本或图片智能创作相关图像内容。该产品支持文本生成图像、图像到图像风格转换、局部修补与替换、AI写真、线稿生图、模特换装、商品背景生成等丰富的图像生成原子能力。与市面上其他AI绘画工具相比，混元生图在中文理解能

人工智能

腾讯云混元生图是基于混元大模型的AI图像生成API，支持文生图、图生图、AI写真等丰富功能。提供同步/异步接口，兼容OpenAI协议，具备中文理解优势。本文详解从服务开通、API调用到提示词优化的全流程，包含Python/Java代码示例，助开发者快速实现AI图像创作。

大模型图像创作引擎

腾讯混元大模型

腾讯混元生图

自然语言处理

计算机视觉

AI图像生成

智能创作

访问管理

密钥管理

DeepSeek

AI绘画

Python

Java

2026上云采购 | AI焕新·智启新局

ai-class

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

腾讯云大模型图像创作引擎对接使用完全指南

腾讯云大模型图像创作引擎对接使用完全指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐