Skill
Skill 是一份给 AI 编程工具读的接入说明。装好后,直接对 Claude Code 等工具说「帮我接入 PhoenixAI 生图」或「用 PhoenixAI 的对话接口写个脚本」,它会按本站的真实接口写代码,而不是凭记忆猜模型名和参数。
Skill 与 MCP 的分工:
| 适合 | 特点 | |
|---|---|---|
| Skill | 让 AI 帮你写集成代码("帮我接入…") | 不需要运行任何进程,也不需要 Node.js |
| MCP | 让 AI 直接帮你生成("生成一张…") | 对话里直接调用工具并拿到结果 |
安装
Claude Code(默认装到 ~/.claude/skills/phoenixai)
curl -fsSL https://ai.suzatei.com/dl/install.sh | bash -s -- --skill其他工具:把下面三个文件放进该工具的 skills / 规则目录即可(保持 references/ 目录结构):
包含什么
- 两套接口的 Base URL、鉴权方式与端点表
- 图像生成的异步流程:提交 → 轮询 → 下载(含 Python / Node.js 完整示例、参考图上传)
- OpenAI 兼容对话接口的调用与流式示例
- 错误码、重试策略(提交不自动重试)
- 「不得编造」规则:模型 id 与参数必须先从
/workspace/api/generate/models、/v1/models实时获取
使用前提
调用接口需要 sk- 模型 Key,在面板创建后设置环境变量,详见 认证:
export PHOENIX_MODEL_KEY="sk-..."