APIMPAPIMP
ユーザーガイドAI API画像 API動画 API公開 API

apimp

apimp は APIMP 公式のユーザー向け Skill プラグインです。Claude Code、Codex、OpenClaw に対応し、自然言語コマンドでモデル、トークン、グループ、残高を管理し、APIMP の使い方も直接質問できます。

apimp-skills とは?

apimp-skills は、APIMP 公式の AI エディター Skill プラグインです。Skills は軽量な拡張プロトコルで、AI コーディングアシスタント(Claude Code、Codex、OpenClaw、Cursor、Windsurf、Cline など)がエディター内で APIMP の API を直接呼び出し、モデルの照会、トークン管理、残高確認に加えて、APIMP のデプロイ、設定、API 利用方法などの質問にもコーディング環境から離れることなく対応できます。

OpenClaw でも利用でき、エージェントのワークフロー内で /apimp コマンドを使ってモデル照会やトークン管理、残高確認を直接実行でき、APIMP の使い方もそのまま質問できます。

Skills を使う理由

日常の AI 開発では、エディターと APIMP 管理ダッシュボードの間を頻繁に行き来する必要があります — 利用可能なモデルの確認、API トークンの作成、残高のチェック、グループ割当の調整など。これらのコンテキストスイッチはコーディングの流れを中断します。

apimp-skills が解決する課題:

  • コンテキストスイッチゼロ:Claude Code、Codex、OpenClaw などの AI IDE で自然言語コマンドを直接入力 — ブラウザや管理パネル不要
  • 組み込みヘルプ:APIMP のデプロイ、設定、グループ、API 呼び出し形式などをその場で質問できます
  • セキュリティファースト:キーは平文で表示されません。トークンのコピーと注入はすべてセキュアチャネルで実行(sk- プレフィックスのキーはターミナル出力やログに表示されません)
  • インストール即使用npx コマンド一行でインストール完了。ランタイム自動検出(Bun / Node.js / Deno)
  • マルチエディター互換:Skills プロトコルを実装するすべての AI エディター・コーディングアシスタントで使用可能

対応 AI エディター

apimp-skills は以下の AI コーディングツールで利用できます:

AI エディター / コーディングアシスタント種類備考
Claude Codeターミナル AI プログラミングアシスタントAnthropic 公式 CLI
OpenClawセルフホスト型 AI アシスタントプラットフォームSkills に対応し、対話内で /apimp コマンドを直接実行可能
CursorAI ネイティブコードエディターVS Code ベース
WindsurfAI コードエディターCodeium 製
ClineVS Code AI 拡張機能オープンソース AI コーディングエージェント
Codex CLIターミナル AI プログラミングアシスタントOpenAI 公式 CLI

Skills プロトコルをサポートするすべてのツールで apimp-skills を使用できます。

コマンドリファレンス

以下は apimp-skills が提供する全コマンドです。これらのコマンドは APIMP REST API を通じて、APIMP インスタンス上のリソースを照会・管理します。

照会コマンド

コマンド説明用途
/apimp models利用可能な AI モデルを一覧表示APIMP インスタンスに設定された全モデル(OpenAI、Claude、Gemini など)を確認
/apimp groupsユーザーグループを一覧表示アカウントのグループとクォータ・倍率設定を確認
/apimp balanceアカウント残高を表示現在のユーザーの残高と使用量をリアルタイム照会

トークン管理コマンド

コマンド説明用途
/apimp tokensAPI トークンを一覧表示作成済みの全トークンを確認(キーはマスク表示、例:sk-reHR**********OspA
/apimp create-token <name> [--group=xxx]新しい API トークンを作成アプリやプロジェクトごとに独立した API キーを生成
/apimp switch-group <token_id> <group>トークンのグループを変更モデルアクセス権限と倍率を調整するためにグループを変更
/apimp copy-token <token_id>キーをクリップボードにコピー実キーをシステムクリップボードに安全にコピー(ターミナルには表示されません)
/apimp apply-token <token_id> <file>設定ファイルにキーを注入プレースホルダー置換によりプロジェクト設定ファイル(例:.env)にトークンキーを安全に書き込み

ヘルプコマンド

コマンド説明用途
/apimp help <question>APIMP について質問APIMP のデプロイ、設定、API 呼び出し形式などのヘルプ情報を取得

インストールと設定

apimp-skills をインストール

npx でワンラインインストール:

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

GitHub リポジトリから最新の Skill 定義を取得し、エディター環境にインストールします。

環境変数を設定

apimp-skills は APIMP インスタンスに接続するために 3 つの環境変数が必要です。シェルプロファイルに追加してください:

# ~/.bashrc または ~/.zshrc
export APIMP_BASE_URL=https://api.apimp.ai
export APIMP_ACCESS_TOKEN=your-access-token
export APIMP_USER_ID=1
変数説明
APIMP_BASE_URLAPIMP サービス URLhttps://api.example.com
APIMP_ACCESS_TOKEN管理者またはユーザーのアクセストークン「個人設定 → アカウント管理 → セキュリティ設定 → システムアクセストークン」から取得
APIMP_USER_IDユーザー ID1(管理者のデフォルトは 1)

プロジェクトルートに .env ファイルを作成する方法もあります。キー漏洩防止のため .env.gitignore に追加してください。

使い始める

インストール後、Skills 対応の AI エディターで /apimp コマンドを入力するだけです。例:

  • /apimp models と入力して利用可能なモデルを確認
  • /apimp balance と入力して現在の残高をチェック
  • /apimp create-token my-app と入力して my-app という新しいトークンを作成
  • /apimp help グループやトークンはどう設定しますか? と入力して APIMP の使い方を質問
  • OpenClaw でも /apimp models/apimp balance などをそのまま利用できます

ランタイム要件

以下のいずれかの JavaScript ランタイムが必要です(起動時に自動検出):

ランタイムバージョン推奨度
Bun最新版推奨(最速)
Node.js>= 18広くサポート
Deno最新版オプション

セキュリティ

apimp-skills は API キーを保護するための多層セキュリティを内蔵しています:

  • トークン一覧ではマスクされたキーのみ表示(例:sk-reHR**********OspA)— 実キーはターミナル出力に表示されません
  • copy-token はキーをシステムクリップボードにのみコピーし、出力には表示しません
  • apply-token はプレースホルダー置換でキーを注入し、生のキー内容を公開しません
  • すべての sk- プレフィックスキー値は実行フロー全体を通じて厳格に保護されます

詳細情報

apimp-skills は現在も活発に開発中で、コマンドや機能はアップデートにより変更される可能性があります。最新の情報と変更ログはリポジトリの README を参照してください:

このガイドはいかがですか?

最終更新