认证
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:
- 登录
https://ai.suzatei.com - 浏览器
F12→ Application → Local Storage →phoenixai_access_token - 复制该值
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 不要提交到代码库;泄露后到面板作废重建