Agent Skill

aibubu-models 是一份写给 AI 的操作说明。agent 在你提到 Aibubu 或需要生成图片、视频时自动加载它，然后按说明完成整个流程：

1. 从 GET /v1/models 查找可用模型，读取参数 schema。
2. 用 POST /v1/quote 报价，用 GET /v1/user/balance 核对余额。
3. 需要参考图时，先上传到 POST /v1/uploads/images。
4. 用 POST /v1/generations 提交任务，轮询 GET /v1/tasks/{task_id}。
5. 任务成功后把结果下载到本地 ./output。

Skill 不包含可执行脚本，agent 按说明直接用 curl 调用接口。

前提条件

• 支持 Skill 的 coding agent，例如 Claude Code、Codex。
• Node.js，用于运行安装命令 npx。
• curl 和 jq。没有 jq 时：brew install jq、apt install jq 或 winget install jqlang.jq。
• API Key，见 API Key 管理。

安装

npx skills add https://docs.aibubu.cn

命令会读取 https://docs.aibubu.cn/.well-known/agent-skills/index.json，下载 aibubu-models 并安装到你选择的 agent。默认安装在当前项目下（例如 ./.claude/skills/）；加 -g 安装到用户目录，所有项目都能用：

npx skills add https://docs.aibubu.cn -g

设置 API Key

Skill 从环境变量 AIBUBU_API_KEY 读取 Key：

# macOS / Linux：写进 ~/.zshrc 或 ~/.bashrc 可长期生效
export AIBUBU_API_KEY=sk_aibubu_your_api_key

# Windows PowerShell：setx 只对之后新开的窗口生效，当前窗口再用 $env: 设置一次
setx AIBUBU_API_KEY "sk_aibubu_your_api_key"
$env:AIBUBU_API_KEY = "sk_aibubu_your_api_key"

设置后，从这个终端重新启动 agent。

验证

对 agent 说：

用 aibubu 生成一张极简风格的未来城市海报，1:1，先告诉我要消耗多少积分

正常情况下，agent 会查询模型列表、报价并告诉你预计积分，确认后提交任务，最后把图片保存到 ./output。

更新

再次执行安装命令即可更新到最新版本：

npx skills add https://docs.aibubu.cn

手动安装

不方便使用 npx 时，可以直接下载归档，解压到 agent 的 Skill 目录。以 Claude Code 为例：

mkdir -p ~/.claude/skills/aibubu-models
curl -sL https://docs.aibubu.cn/.well-known/agent-skills/aibubu-models.tar.gz \
  | tar -xz -C ~/.claude/skills/aibubu-models

常见问题