CLI

在终端调用 PhoenixAI 生图。不需要源码，Node.js ≥ 18 即可。

安装

一键安装

curl -fsSL https://ai.suzatei.com/dl/install.sh | bash

或用 npm 装安装包（始终指向最新版）

npm install -g https://ai.suzatei.com/dl/phoenix-cli-latest.tgz

安装后可直接使用 phoenix 命令：

phoenix help

配置

推荐：直接用 API Key（不必登录）

export PHOENIX_MODEL_KEY=sk-你的Key
export PHOENIX_BASE_URL=https://ai.suzatei.com   # 可省略，默认就是线上
phoenix models --json

可选：绑定账号（要生成历史 / 多设备时）。登录 https://ai.suzatei.com 后，从浏览器 localStorage 复制 phoenixai_access_token（详见认证）：

phoenix auth login --url https://ai.suzatei.com --token <access_token>
phoenix auth status

环境变量优先级高于配置文件：

变量	说明
`PHOENIX_MODEL_KEY`	模型 Key（`sk-...`，推荐）
`PHOENIX_BASE_URL`	站点地址，默认 `https://ai.suzatei.com`
`PHOENIX_TOKEN`	账号 access_token（可选）

常用命令

列出模型

phoenix models --json                       # 精简目录：模型 id、名称、是否需要参考图、基础参数名
phoenix models --model <模型ID> --json      # 某个模型的完整参数定义（含高级参数、可选值、默认值）
phoenix models --full --json                # 完整目录（体积较大）

返回的 series[].modes[].model 就是下面命令要用的模型 id。精简目录里的 needsRefs: true 表示该模式需要参考图，CLI 暂不支持，请用 HTTP API。

文生图（等待完成）

phoenix generate image google/nano-banana-2/text-to-image \
  -p "一只浴火重生的凤凰" --json

参数	说明
`-p`、`--prompt`	提示词（必填）
`--params-json '{"size":"1024*1024"}'`	模型私有参数，字段见 `phoenix models` 返回的 `params`
`--no-wait`	只提交、不等待，立即返回任务 id
`--json`	输出 JSON

只提交、不等待

phoenix generate image google/nano-banana-2/text-to-image \
  -p "星空下的小屋" --no-wait --json

查询 / 等待任务

phoenix generate get <generation_id> --json
phoenix generate wait <generation_id> --json

结果与下载

完成后返回的 results 是完整的可下载 URL（链接自带访问令牌，无需再带 Key）。结果文件只保留一段时间（默认约 6 小时），请及时保存：

url=$(phoenix generate image bytedance/seedream-v5.0-pro/text-to-image \
  -p "product shot, white background" --json | jq -r '.results[0]')
curl -o out.png "$url"

限制

只支持纯文生图；需要参考图的编辑类模式请用 HTTP API
默认等待 180 秒，超时报错里会带上任务 id，再用 phoenix generate wait <id> 继续等

卸载

npm uninstall -g phoenix-cli

本地开发（仅贡献者）

若你克隆了源码仓库：

cd phoenix-tools/cli
npm link