安装 modelfold-models

让你的编程 Agent 直接使用 ModelFold 上的图片、视频、语音和对话模型。

modelfold-models 教会 Agent 使用 ModelFold：查模型列表、按模型类型选接口、提交请求、等待结果并保存文件。

---

先决条件

• 一个支持 skill 的编程 Agent，例如 Claude Code、Codex 或 Cursor。
• 已安装 Node.js（需要用到 npx）。
• 一个 ModelFold API Key，在 控制台 → API Keys 创建；账户里要有积分。

---

第 1 步：安装 skill

每台机器只需运行一次：

npx skills add https://ai.modelfold.online

以后再运行一次同样的命令即可更新到最新版本。

---

第 2 步：设置 API Key

skill 从环境变量 MODELFOLD_API_KEY 读取密钥，不需要把密钥写进项目里。

macOS 与 Linux

在启动 Agent 的同一个 shell 里导出，或者写进 shell profile（~/.zshrc、~/.bashrc）：

export MODELFOLD_API_KEY=your_key

Windows（PowerShell）

$env:MODELFOLD_API_KEY = "your_key"
setx MODELFOLD_API_KEY "your_key"

setx 只对之后新开的窗口生效。想立刻用上，同时设 $env:。

---

第 3 步：试一下

在已设置 MODELFOLD_API_KEY 的 shell 里重启 Agent，然后直接用自然语言提需求：

Use the modelfold-models skill to list the image models on ModelFold, then generate a 1:1 product photo of a white ceramic mug on a light oak table with one of them. Save the image to ./output.

Agent 会读取实时模型列表、调用图像生成接口、等待结果，并把文件保存到 ./output。每次成功调用会扣对应的积分，失败的任务自动退款。

---

安全

• 把 API Key 放在环境变量里，不要贴进聊天、截图或会提交到仓库的文件。
• 密钥泄露后，立即到 控制台 → API Keys 吊销并新建。