APIMPAPIMP
User GuideAI APIImage APIVideo APIPublic API

apimp

apimp is the official APIMP user-level Skill for Claude Code, Codex, and OpenClaw. Query models, manage tokens, view groups, check balance, and ask APIMP usage questions directly inside your AI coding workflow.

What is apimp-skills?

apimp-skills is the official AI editor Skill plugin from APIMP. Skills are a lightweight extension protocol that enables AI coding assistants — such as Claude Code, Codex, OpenClaw, Cursor, Windsurf, and Cline — to call APIMP endpoints directly from within the editor, performing model queries, token management, balance checks, and answering APIMP deployment, configuration, and API usage questions without ever leaving your coding environment.

It now also works inside OpenClaw, so you can run /apimp commands for models, tokens, groups, and balance, and ask APIMP usage questions without leaving your agent workflow.

Why Use Skills

During everyday AI development, developers frequently switch between their editor and the APIMP management dashboard — checking available models, creating API tokens, inspecting balance, adjusting group quotas. These context switches disrupt coding flow.

What apimp-skills solves:

  • Zero context-switching: Issue natural language commands directly in Claude Code, Codex, OpenClaw, or other AI IDEs — no browser or admin panel needed
  • Built-in help: Ask about APIMP deployment, configuration, groups, and API call formats directly from your coding workflow
  • Security-first design: Keys are never shown in plain text; token copy and injection use secure channels (sk- prefixed keys never appear in terminal output or logs)
  • Instant setup: A single npx command handles installation; runtime auto-detection (Bun / Node.js / Deno)
  • Cross-editor compatibility: Works with any AI editor or coding assistant that implements the Skills protocol

Supported AI Editors

apimp-skills works with the following AI coding tools:

AI Editor / Coding AssistantTypeNotes
Claude CodeTerminal AI programming assistantOfficial Anthropic CLI
OpenClawSelf-hosted AI assistant platformSupports Skills-based /apimp command workflows
CursorAI-native code editorVS Code based
WindsurfAI code editorBy Codeium
ClineVS Code AI extensionOpen-source AI coding agent
Codex CLITerminal AI programming assistantOfficial OpenAI CLI

Any tool that supports the Skills protocol can use apimp-skills.

Commands Reference

Below is the complete list of commands provided by apimp-skills. These commands interact with the APIMP REST API to query and manage resources on your APIMP instance.

Query Commands

CommandDescriptionUse Case
/apimp modelsList available AI modelsView all models configured on your APIMP instance (OpenAI, Claude, Gemini, etc.)
/apimp groupsList user groupsView your account's groups with quota and rate multiplier settings
/apimp balanceShow account balanceReal-time query of current user's balance and usage

Token Management Commands

CommandDescriptionUse Case
/apimp tokensList API tokensView all created tokens (keys shown masked, e.g. sk-reHR**********OspA)
/apimp create-token <name> [--group=xxx]Create new API tokenGenerate independent API keys for different apps or projects
/apimp switch-group <token_id> <group>Change token's groupModify token group to adjust model access permissions and rate multipliers
/apimp copy-token <token_id>Copy key to clipboardSecurely copy the real key to system clipboard (key never displayed in terminal)
/apimp apply-token <token_id> <file>Inject key into config fileSecurely write token key into project config files (e.g. .env) via placeholder replacement

Help Command

CommandDescriptionUse Case
/apimp help <question>Ask about APIMPGet help on APIMP deployment, configuration, API call formats, and more

Installation & Configuration

Install apimp-skills

One-line installation via npx:

npx skills add https://github.com/pixzoo/skills --skill apimp

This pulls the latest Skill definition from the GitHub repository and installs it into your editor environment.

Set Environment Variables

apimp-skills requires three environment variables to connect to your APIMP instance. Add them to your shell profile:

# ~/.bashrc or ~/.zshrc
export APIMP_BASE_URL=https://api.apimp.ai
export APIMP_ACCESS_TOKEN=your-access-token
export APIMP_USER_ID=1
VariableDescriptionExample
APIMP_BASE_URLAPIMP service URLhttps://api.example.com
APIMP_ACCESS_TOKENAdmin or user access tokenFrom "Personal Settings → Account → Security → System Access Token"
APIMP_USER_IDUser ID1 (admin default is 1)

You can also create a .env file in your project root. Make sure .env is listed in .gitignore to prevent key leaks.

Start Using

Once installed, type /apimp commands in any Skills-compatible AI editor. For example:

  • Type /apimp models to list available models
  • Type /apimp balance to check your current balance
  • Type /apimp create-token my-app to create a new token named my-app
  • Type /apimp help how do I configure groups and tokens? to ask APIMP usage questions directly
  • In OpenClaw, you can also run /apimp models, /apimp balance, and token commands directly in your agent workflow

Runtime Requirements

apimp-skills requires one of the following JavaScript runtimes (auto-detected at startup):

RuntimeVersionRecommendation
BunLatestRecommended (fastest)
Node.js>= 18Widely supported
DenoLatestOptional

Security

apimp-skills has multiple layers of security built in to protect your API keys:

  • Token listings only show masked keys (e.g. sk-reHR**********OspA) — real keys never appear in terminal output
  • copy-token copies the key to the system clipboard only, never displaying it in any output
  • apply-token uses placeholder replacement to inject keys, never exposing raw key content
  • All sk- prefixed key values are strictly protected throughout the entire execution flow

Learn More

apimp-skills is under active development — commands and features may change with updates. Refer to the repository README for the latest information and changelog:

How is this guide?

Last updated on