PhoenixAI Tools

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-..."