本文是「腾讯云混元生图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 可以复现同样的画面。
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 以相同方式调用，一通百通。
