腾讯云CLI × 混元生图实战：用一行命令生成图片

本文是「腾讯云混元生图CLI实践」系列第 1 篇（共 2 篇）：

• 第 1 篇（本文）：从零开始，在终端用腾讯云 CLI 调用混元生图接口——适合想理解底层原理、有脚本化/批量需求的开发者。
• 第 2 篇：《CodeBuddy × 混元生图实战：用 CLI Skill 一键出图》结合CodeBuddy等平台，用 CLI Skill 一键生图，开箱即用——适合日常开发中快速出图。

为什么选择 CLI 方式？

大多数人使用 AI 生图时，习惯打开 Web 控制台或第三方应用。但如果你是一个热衷于终端操作的开发者，或者需要在脚本中批量生成图片，那么 CLI 方式会是更高效的选择：

• 无需 GUI：SSH 到远程服务器也能用；
• 易于脚本化：结合 Shell 脚本实现批量生图；
• 调试友好：原始 JSON 响应一目了然，方便排查问题。

本文将从以下四步走完整个流程。

Step 1：安装腾讯云命令行工具 TCCLI

前往 腾讯云 CLI 产品页 按照指引完成安装。安装完毕后，跑一下版本命令确认环境就绪：

tccli --version

看到版本号输出，说明安装成功，可以继续下一步。

Step 2：获取并配置 API 密钥

调用腾讯云接口时，需要一对 SecretId / SecretKey 作为身份凭证（同时需求确保开通该密钥对应的服务）。

获取密钥

登录 腾讯云控制台，进入 访问管理 > API 密钥管理 页面，创建或查看已有密钥。

控制台的密钥管理界面，复制你的 SecretId 和 SecretKey 备用

配置密钥到 TCCLI

参考 TCCLI 配置文档，运行交互式配置命令完成设置。配置完成后，验证一下：

tccli configure list

确认 SecretId / SecretKey 已正确写入

至此，CLI 工具已经就绪。

Step 3：命令执行

腾讯云的 aiart TextToImageRapid 接口支持通过文本 Prompt 快速生成图片。

接口说明

前往 API Explorer - TextToImageRapid 可以在线查看参数说明和调试。 页面中切换到 CLI 示例 标签，就能直接复制可用的命令行指令。 API Explorer 提供了在线调试和多语言示例，非常方便。

执行生图命令

打开终端，粘贴以下命令：

tccli aiart TextToImageRapid \
 --cli-unfold-argument \
 --region ap-guangzhou \
 --Prompt '画一副马年风格的年画'

几秒钟后，你会收到如下格式的 JSON 响应：

{
  "Response": {
    "RequestId": "e77c02f6-44b1-4e67-a503-844ebb44f067",
    "ResultImage": "<Base64 编码的图片数据或 URL>",
    "Seed": 4180030109
  }
}

其中 ResultImage 就是生成图片的 Base64 编码数据，Seed 是随机种子——记下它，下次传入相同 Seed 可以复现同样的画面。

终端输出的原始 JSON 结果

Step 4：解码 Base64，生成图片

接口返回的是 Base64 字符串，还需要解码才能得到可查看的 PNG 文件。

方式一：Python 脚本（推荐）

将 CLI 返回的 JSON 保存为 shengtu.json，然后运行：

import json
import base64
​
with open("shengtu.json", "r") as f:
  data = json.load(f)
​
img_data = base64.b64decode(data["ResultImage"])
with open("result_image.png", "wb") as f:
  f.write(img_data)

方式二：命令行一行搞定

如果你追求极简，一行命令也能完成解码：

python3 -c "
import json, base64
data = json.load(open('shengtu.json'))
open('result_image.png','wb').write(base64.b64decode(data['ResultImage']))
"

解码完成后，打开 result_image.png，就能看到混元模型为你生成的画作了。

适用场景

除了本文演示的单次生图，腾讯云CLI+混元生图的方式在以下场景同样适用：

• 批量运营素材：电商大促需要 100+ 张商品主图/场景图，Shell 循环 + Prompt 文件批量出图；
• CI/CD 自动封面：代码合并后自动为文章/Release 生成封面，嵌入流水线无需人工；
• A/B 测试素材：同一主题不同 Prompt/Style 快速生成多组方案，脚本化对比；
• 定时素材更新：结合 cron 定时生成天气/节日/热点配图，用于自动化推送；
• 游戏/内容资产：批量生成 NPC 头像、道具图、场景概念图，Seed 固定可复现。

小结

从安装 CLI 到生成第一张图片，整个流程只需要四步，既直接又灵活。以终端为画布，才是更适合开发者的生图方式。

同样的思路也适用于腾讯云 OCR、ASR、TTS、生视频、生3D等其他AI能力，用户可通过 TCCLI 以相同方式调用，一通百通。