Agent Skill

aibubu-models is a set of instructions written for AI agents. The agent loads it when you mention Aibubu or ask for an image or video, then follows it end to end:

1. Find available models with GET /v1/models and read their parameter schema.
2. Quote with POST /v1/quote and check the balance with GET /v1/user/balance.
3. Upload reference images to POST /v1/uploads/images when needed.
4. Submit with POST /v1/generations and poll GET /v1/tasks/{task_id}.
5. Download the results to ./output once the task succeeds.

The skill contains no executable scripts; the agent calls the API with curl as instructed.

Prerequisites

• A coding agent that supports skills, such as Claude Code or Codex.
• Node.js, for the npx install command.
• curl and jq. To install jq: brew install jq, apt install jq or winget install jqlang.jq.
• An API key; see API Keys.

Install

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

The command reads https://docs.aibubu.ai/.well-known/agent-skills/index.json, downloads aibubu-models and installs it into the agents you select. It installs into the current project by default (for example ./.claude/skills/); add -g to install for your user so every project can use it:

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

In Claude Code you can also install the official plugin, which bundles the skill and the remote MCP server:

/plugin marketplace add aibubu2026/aibubu-skills
/plugin install aibubu-global@aibubu

Set your API key

The skill reads the key from AIBUBU_API_KEY:

# macOS / Linux: add this to ~/.zshrc or ~/.bashrc to keep it
export AIBUBU_API_KEY=sk_aibubu_your_api_key

# Windows PowerShell: setx only affects new windows, so also set $env: for this one
setx AIBUBU_API_KEY "sk_aibubu_your_api_key"
$env:AIBUBU_API_KEY = "sk_aibubu_your_api_key"

Then restart your agent from that terminal.

Verify

Ask your agent:

Use aibubu to make a minimalist poster of a futuristic city, 1:1. Tell me how many credits it will cost first.

The agent should list models, quote and tell you the estimated credits, submit after you confirm, and save the image to ./output.

Update

Run the install command again to get the latest version:

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

Manual install

If you cannot use npx, download the archive and extract it into your agent's skills folder. For Claude Code:

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

Troubleshooting