MeituHub 是美图的 AI 影像开放平台，提供三种接入方式，你可以根据自己的角色和使用场景选择最合适的一种：

只想快速体验效果，选 Agent 画布； 需要本地批量产出，选 CLI； 需要把影像能力集成到自己的系统里，选 OpenAPI。

---

方式一：Agent 画布（零代码，最快开始）

不写任何代码，登录账号后在对话中直接描述需求，Agent 会帮你完成图片生成、视频创作等任务。

链接：https://meituhub.cn/zh-cn/chat

开始使用：

1. 打开工作台，点击页面右下角「登录」，完成登录 / 注册。
2. 在输入框直接提问，例如"你有哪些能力"，或点击顶部行业模板卡片（游戏 / 电商 / 教育 / 营销设计）自动填充任务描述。
3. 按需调整输入内容，点击发送。
4. 等待任务完成，查看生成结果；支持上传附件，也可随时停止生成。

无需了解参数与模型，也无需准备 Key，适合快速验证创意。

---

方式二：CLI（meitu-cli）

面向本地批量处理与脚本自动化。安装后通过命令行调用平台能力，完整命令见 meitu-cli 命令文档。

开始使用：

1. 安装

   npm install -g meitu-cli meitu

   若提示找不到 meitu，请重新打开终端后再试（仅适用于全局安装）。

2. 配置凭证

   登录 MeituHub 后，在站内复制 Access Key 与 Secret Key。

   本地配置（推荐）：

   meitu config set-ak --value <ACCESS_KEY>
   meitu config set-sk --value <SECRET_KEY>

   使用 npx 时：

   npx -y meitu-cli config set-ak --value <ACCESS_KEY>
   npx -y meitu-cli config set-sk --value <SECRET_KEY>

   或使用环境变量（优先于本地文件，适用于 CI / Agent）：

   export MEITU_OPENAPI_ACCESS_KEY="<ACCESS_KEY>"
   export MEITU_OPENAPI_SECRET_KEY="<SECRET_KEY>"

3. 验证凭证

   meitu auth verify --json

   返回 code: 0 或 ok: true 即表示凭证有效。若失败，请检查 Key 是否完整复制、无首尾空格。

   首次使用建议同步命令元数据：

   meitu tools update

4. 运行首条命令

   创建输出目录并生成一张图片：

   mkdir -p ./output
   meitu text-to-image \
     --prompt "一只橘猫，简约插画" \
     --size 2K \
     --json \
     --download-dir ./output

   成功标志：output 目录下生成图片文件，且 JSON 中 code 为 0 或 ok: true。

参数说明可查看 meitu <command> --help；异步视频任务若超时，可用 meitu task wait <task_id> --timeout-ms 600000 --json 手动轮询。

---

方式三：OpenAPI（服务端集成）

面向需要把影像能力深度集成到自身系统的开发者。接入基于 Access Key（AK）+ Secret Key（SK） 与 SDK-HMAC-SHA256 签名，详见 API AK/SK 签名接入指南。

开始使用：

1. 获取凭证

   登录 MeituHub 获取 AK 与 SK。SK 只能保存在服务端，不得写入客户端代码。

2. 选择 SDK

   已提供多种语言签名 SDK：Python、Java、Go、JavaScript、PHP、C#、Kotlin、Swift、Bash/Shell 等。示例见 Python 签名 SDK 接入指南。

3. 发起首个请求

   构造参与签名的请求（HTTP 方法、URL、查询参数、请求头、请求体均参与 SHA-256 签名），示例接口：

   POST https://openapi.meitu.com/api/v1/sdk/sync/push

4. 处理结果

   同步任务直接返回结果；异步任务通过 GET /api/v1/sdk/status?task_id=<task_id> 轮询任务状态。

注意：body 不超过 12M 时使用 AK/SK 认证；超过 12M 时按对应能力 API 文档改用 Token 认证。 请求签名后不得再次修改 URL、查询参数、请求头或请求体；每次请求需生成新的 X-Sdk-Date 与 Authorization。

---