快速开始
1. 安装
npm install -g meitu-cli
meitu --version若提示找不到 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）
macOS / Linux：
export MEITU_OPENAPI_ACCESS_KEY="<ACCESS_KEY>"
export MEITU_OPENAPI_SECRET_KEY="<SECRET_KEY>"Windows（PowerShell）：
$env:MEITU_OPENAPI_ACCESS_KEY = "<ACCESS_KEY>"
$env:MEITU_OPENAPI_SECRET_KEY = "<SECRET_KEY>"3. 验证
meitu auth verify --json返回 code: 0 或 ok: true 即表示凭证有效。若失败，请检查 Key 是否完整复制、无首尾空格。
首次使用建议同步命令元数据：
meitu tools update4. 运行首条命令
创建输出目录：
mkdir -p ./output文生图示例：
meitu text-to-image \
--prompt "一只橘猫，简约插画" \
--size 2K \
--json \
--download-dir ./outputWindows 用户可将 ./output 改为 .\output；创建目录可使用 New-Item -ItemType Directory -Force .\output。
成功标志：output 目录下生成图片文件，且 JSON 中 code 为 0 或 ok: true。
补充说明
| 参数 / 命令 | 说明 |
|---|---|
--json | 输出结构化 JSON，便于脚本集成 |
--download-dir | 将结果文件下载到指定目录 |
meitu --help | 查看全部命令 |
meitu <command> --help | 查看单命令参数 |
异步任务若超时，可手动轮询：meitu task wait <task_id> --timeout-ms 600000 --json（视频类建议适当增大超时）。
更多命令执行 meitu --help 查看。