Install modelfold-models

Let your coding agent use ModelFold's image, video, speech and chat models directly.

modelfold-models teaches the agent how to use ModelFold: read the model list, pick the endpoint for the model type, send the request, wait for the result and save the file.

---

Prerequisites

• A skill-aware coding agent such as Claude Code, Codex or Cursor.
• Node.js installed (for npx).
• A ModelFold API key from Console → API Keys, and credits in your wallet.

---

Step 1: Install the skill

Run once per machine:

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

Run the same command again later to update to the latest version.

---

Step 2: Set your API key

The skill reads the key from the MODELFOLD_API_KEY environment variable, so it never goes into your project.

macOS and Linux

Export it in the shell you start the agent from, or add it to your 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 only affects windows opened afterwards. To use it right away, set $env: as well.

---

Step 3: Try it

Restart the agent from a shell where MODELFOLD_API_KEY is set, then ask in plain language:

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.

The agent reads the live model list, calls the image generation endpoint, waits for the result and saves the file to ./output. Each successful call uses credits; failed jobs are refunded automatically.

---

Security

• Keep the API key in an environment variable. Don't paste it into chats, screenshots or files that get committed.
• If a key leaks, revoke it in Console → API Keys and create a new one.