apimodels Agent Skill
Skill 是给编码 agent(Claude Code、Cursor、Codex 等)的能力包:装上之后,直接对 agent 说「画一张竖版咖啡店海报」,它会自己挑合适的模型、先告诉你花多少钱、生成、把文件交给你 —— 你不需要记任何模型名或 API 细节。
安装
推荐走 Skills CLI(skills.sh 生态,一条命令覆盖 Claude Code、Cursor、Codex、Cline、Gemini CLI 以及 skills.sh 支持的其他 agent):
npx skills add stimQQ/apimodels-skill@apimodels-image注意:技能名是 apimodels-image(来自 SKILL.md),不是目录名 image。写成 @image 会报 “No matching skills found”。
手动安装(仅 Claude Code)
git clone https://github.com/stimQQ/apimodels-skill
cp -r apimodels-skill/image ~/.claude/skills/apimodels-imageclaude.ai 网页版 / 桌面版:上传 zip
cd apimodels-skill && zip -r apimodels-image.zip image -x '*.DS_Store'
# claude.ai → Settings → Capabilities → 开启 Code execution
# → Customize → Skills → + Create skill → 上传 zipzip 要以 image/ 目录为根打包(不是仓库根目录),否则 claude.ai 识别不到 SKILL.md。
配置 API Key:浏览器点一下就好
装完后让 agent 跑(或自己在终端跑)下面这条命令。它会打开一个 apimodels.app 授权页,你登录后点一下「授权」,一把名为「CLI · 日期」的专属 key 就会自动创建并写进这台电脑 —— 全程不需要复制粘贴任何密钥,key 也不会出现在对话、终端历史或浏览器地址栏里。
node ~/.claude/skills/apimodels-image/scripts/generate.mjs --login验证一下(会顺便显示余额):
node ~/.claude/skills/apimodels-image/scripts/generate.mjs --check两个备选:已经有 key 的老用户可以直接设环境变量 APIMODELS_API_KEY;完全没有浏览器的机器(CI、纯 SSH)用 --save-key 从标准输入喂 key。不再用的 key 随时可在控制台单独删除。
安全习惯:永远不要把 key 粘贴进和 AI 的对话里 —— 进了对话就进了记录。上面的 --login 流程正是为了让这件事从此不再必要。
怎么用
不需要任何仪式感 —— 装好后用自然语言提需求即可。技能会让 agent 遵守这些约定:
| 你说 | agent 做 |
|---|---|
| 「做一张 2K 的产品图,文字要清楚」 | 选 gpt-image-2($0.03/2K,小字最稳),先报价再生成 |
| 「把这两张参考图融成一张海报」 | 选支持多参考图的模型,说明选择理由 |
| 「批量出 8 张分镜草图」 | ≥5 张必先报总价、等你确认才动手 |
| 「这张图放大到 4K」 | 走 Real-ESRGAN 放大链路,不重绘内容 |
使用细节与注意事项
- 模型名以 data/models.json 为准。技能明令 agent 不得凭记忆编模型名或报价 —— 价格、模型 ID、文档链接都从随技能分发的实时清单里读。
- 失败不扣费。生成失败时 agent 会直说,并给出重试或换模型的选项。
- 结果链接 30 天有效。需要长期保存就让 agent 用 --out 落到本地文件。
- 更新技能:
npx skills update(skills CLI 安装的);手动安装的重跑一遍 clone + cp。 - 排错第一步:跑 --check。它会区分「没配 key」「key 无效」「余额不足」三种情况并给出对应指引。
- 沙箱环境(claude.ai):沙箱看不到你电脑的环境变量,key 用 zip 安装后按 agent 的提示配置;凭据存在会话沙箱里,重开会话可能需要重新配置。
后续
视频技能(Seedance、Kling、VEO、MiniMax Hailuo)与语音技能(ElevenLabs、Suno、MiniMax)在计划中,会进同一个仓库、同一种安装方式。