APIMODELSAPIMODELS
Agent Skill · apimodels-image · 33 个图片模型

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-image

claude.ai 网页版 / 桌面版:上传 zip

cd apimodels-skill && zip -r apimodels-image.zip image -x '*.DS_Store'
# claude.ai → Settings → Capabilities → 开启 Code execution
# → Customize → Skills → + Create skill → 上传 zip

zip 要以 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)在计划中,会进同一个仓库、同一种安装方式。