腾讯混元生图API快速入门-人工智能-PHP中文网

本文提供腾讯混元生图api的最小可行调用链：先在腾讯云开通服务并获取secretid/secretkey，配置环境变量；再安装sdk、初始化客户端验证鉴权；最后调用texttoimage接口传入prompt等参数，获取base64图片并解码为png文件。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

腾讯混元生图api快速入门

想用腾讯混元的生图能力快速生成一张高质量图片，又不想被复杂的鉴权流程和JSON结构卡住？本文直接给出可立即运行的最小可行调用链，从获取凭证到拿到base64图片结果，全程不绕弯。

申请并配置API密钥

登录腾讯云控制台→访问【AI与机器学习】→进入【混元大模型】→点击左侧【模型服务】→选择【混元生图】→开通服务后，在【API密钥管理】页点击【新建密钥】，生成SecretId和SecretKey。

将生成的SecretId和SecretKey保存到本地环境变量中，例如在终端执行：export TENCENTCLOUD_SECRET_ID="AKIDxxx" 和 export TENCENTCLOUD_SECRET_KEY="xxx"。这一步漏掉会导致后续所有请求返回401错误。

确认当前地域为ap-beijing（北京），混元生图API目前仅在该地域可用，其他地域请求会直接失败。

安装SDK并验证连通性

执行命令安装官方SDK：pip install tencentcloud-sdk-python。

新建test_auth.py，写入以下代码并运行：

（只需复制粘贴，无需修改）

```python
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.hunyuan.v20230901 import hunyuan_client

cred = credential.Credential(
os.getenv("TENCENTCLOUD_SECRET_ID"),
os.getenv("TENCENTCLOUD_SECRET_KEY")
)
http_profile = HttpProfile()
http_profile.endpoint = "hunyuan.tencentcloudapi.com"
client_profile = ClientProfile(http_profile=http_profile)
client = hunyuan_client.HunyuanClient(cred, "ap-beijing", client_profile)
print("认证通过，客户端初始化成功")
```

若输出“认证通过，客户端初始化成功”，说明密钥、地域、端点三者全部匹配；若报错，请回头检查环境变量是否生效、SecretKey是否含空格、地域是否写成beijing而非ap-beijing。

发送生图请求并解析响应

方法一：使用SDK原生接口（推荐）

在上一步的Python脚本末尾追加以下代码：

```python
from tencentcloud.hunyuan.v20230901.models import TextToImageRequest

req = TextToImageRequest()
req.Prompt = "一只橘猫坐在窗台上看夕阳，写实风格，柔焦，8K"
req.NegativePrompt = "模糊，畸变，文字，水印"
req.Size = "1024x1024"

resp = client.TextToImage(req)
image_base64 = resp.Response.ResultImage
print("图片base64已获取，长度：", len(image_base64))
```

php获得文件的mime type类

下载

运行后，控制台将输出base64字符串。注意：该字符串不含data:image/png;base64,前缀，如需网页预览，需手动拼接。

方法二：用requests手写HTTP请求（适合调试）

第一步：构造Authorization签名头 → 第二步：组装JSON payload → 第三步：POST到https://hunyuan.tencentcloudapi.com → 第四步：提取Response.ResultImage字段值。

【必须设置Content-Type为application/json；否则返回415错误】

方法三：用curl快速验图（终端一行命令）

把下面命令中的[SECRET_ID]、[SECRET_KEY]、[SIGNATURE]替换成真实值（签名需用HMAC-SHA256生成，建议先用SDK生成一次再抄签名串），然后执行：

curl -X POST https://hunyuan.tencentcloudapi.com -H "Authorization: TC3-HMAC-SHA256 Credential=[SECRET_ID]/2026-07-23/ap-beijing/hunyuan/tc3_request, SignedHeaders=content-type;host;x-tc-action;x-tc-timestamp, Signature=[SIGNATURE]" -H "Content-Type: application/json" -H "X-Tc-Action: TextToImage" -H "X-Tc-Timestamp: 1753293960" -H "X-Tc-Version: 2023-09-01" -d '{"Prompt":"一只橘猫坐在窗台上看夕阳","Size":"1024x1024"}'

响应体中"ResultImage"字段即为base64图片数据，复制该值并保存为output.txt即可下一步解码。

将base64转为本地图片文件

新建decode.py，写入：

```python
import base64

with open("output.txt", "r") as f:
b64str = f.read().strip()

with open("result.png", "wb") as f:
f.write(base64.b64decode(b64str))
```

运行该脚本，当前目录下将生成result.png——这就是混元生成的首张图片。