PhoenixAI Tools

认证

CLI / MCP / HTTP API / LLM API 与工作台同一套鉴权。推荐直接用 API Key,一个 Key 通用。

API Key(推荐)

在面板创建 sk- 开头的模型 Key,然后:

export PHOENIX_MODEL_KEY="sk-..."
phoenix models --json
phoenix generate image google/nano-banana-2/text-to-image -p "一只凤凰" --json
变量说明
PHOENIX_MODEL_KEY模型 Key(sk-...,推荐)
PHOENIX_BASE_URL站点地址,默认 https://ai.suzatei.com

有效 Key 即可调用生图与对话接口(直接发 HTTP 请求时:生图接口用请求头 X-Model-Key: sk-...,LLM 接口用 Authorization: Bearer sk-...,详见 HTTP API 与 LLM API),费用记在该 Key 上。

账号 Token(可选)

若要绑定 PhoenixAI 账号(生成历史、多设备、账号级权限),再登录取 token:

  1. 登录 https://ai.suzatei.com
  2. 浏览器 F12 → Application → Local Storage → phoenixai_access_token
  3. 复制该值
export PHOENIX_TOKEN="eyJ..."
# 或
phoenix auth login --url https://ai.suzatei.com --token "eyJ..."

同时存在账号 Token 与 Key 时,优先账号身份。

权限说明

  • 有效模型 Key 或登录账号均可调用生成接口
  • 生成费用走所用 Key 的额度
  • 余额不足时返回 403 INSUFFICIENT_QUOTA,见 错误码与重试
  • 如需收紧(例如仅管理员试用),服务端可设 WS_GENERATE_MIN_ROLE=10

安全建议

  • 配置文件 ~/.phoenixai/config.json 权限为 600
  • CI 中用环境变量注入 Key / Token,不要写进仓库
  • Key 不要提交到代码库;泄露后到面板作废重建