AIHubMix Skill は、AI コーディング Agent 向けのローカル拡張機能です。インストール後は、Codex、Claude Code、Cursor、Cline など Skills 対応 Agent の中で、自然言語だけで AIHubMix の接続、モデル検索、能力別の選定、サンプル生成、エラー調査を行えます。
この Skill は固定のモデル一覧を内蔵しません。必要なときに AIHubMix 公式 API からモデル、価格、コンテキスト長、プロトコル契約などのリアルタイム情報を取得し、Agent が古い記憶に依存しないようにします。
利用シーン
| シーン | こう言えます | Skill が行うこと |
|---|
| AIHubMix を接続 | “このプロジェクトを AIHubMix に接続して” | プロジェクト構成を判定し、適切なプロトコルを選び、最小構成の実行可能な接続方法を示します |
| モデルを検索 | “gemini の最新利用可能モデルを調べて” | AIHubMix のリアルタイムモデル API から結果を取得して整理します |
| 能力で選定 | “利用できる画像入力モデルは？” | vision、画像生成、動画、TTS、STT、embedding、rerank などの能力で候補モデルを絞り込みます |
| サンプル生成 | “Anthropic messages の呼び出し例を出して” | OpenAI、Anthropic、Gemini などのプロトコル向けに実行可能な例を生成します |
| Key を確認 | “このモデルが使えるか確認して” | 実際の最小リクエストで API Key とモデルの呼び出し可否を検証します |
| エラー調査 | “この 401 / 400 はなぜ？” | エンドポイント、モデル、エラー本文、リクエスト ID をもとに対処方法を分析します |
前提条件
- Codex、Claude Code、Cursor、Cline、Gemini CLI、OpenCode など、Skills 対応 AI Agent を少なくとも 1 つインストールしていること。
- ローカルで Python 3.8 以上を実行できること。
- 実際にモデルを呼び出す場合は、AIHubMix API Key を用意してください。
- 残高、Key 一覧、現在のアカウントで呼び出せるモデルを確認する場合は、公式
aihubmix CLI を追加でインストールしてログインしてください。
インストール
方法 1: Agent にインストールしてもらう
現在使っている AI Agent に、次の指示を渡します。
https://github.com/AIhubmix/skills から AIHubMix Skill を取得し、現在のツールの Skills ディレクトリに配置してください。
Claude Code では ~/.claude/skills、
Codex では ~/.codex/skills を使用できます。
インストール後、python <skill>/scripts/AiHubMixAPI.py --help を実行して確認してください。
方法 2: 手動インストール
# Claude Code
cp -r AiHubMixAPI ~/.claude/skills/
# Codex
cp -r AiHubMixAPI ~/.codex/skills/
Agent によって Skills ディレクトリは異なります。使用中のツールが共有ディレクトリを使う場合は、その Agent の Skills ドキュメントを先に確認するか、Agent にインストール先を判断させてください。
任意: AIHubMix CLI をインストール
AiHubMixAPI スクリプトは公開モデル情報とプロトコル情報を取得できます。アカウント残高、Key 管理、現在のアカウントで実際に呼び出せるモデルなどは、公式 CLI にログインして確認します。
# Windows
irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
aihubmix login
aihubmix whoami
aihubmix models list
使い方
インストール後は、通常コマンドを覚える必要はありません。Agent に直接タスクを伝えます。
この Next.js プロジェクトを AIHubMix に接続し、呼び出し可能なテキストモデルで smoke test を実行して。
AIHubMix 上の Claude 系列の最新モデルと価格を調べて。
使える画像生成モデルは？現在のアカウントで呼び出せるものだけ表示して。
このエンドポイントが 401 を返します。Key、Base URL、モデル権限のどれが原因か確認して。
/AiHubMixAPI gemini の最新モデルを調べて
/AiHubMixAPI この 400 エラーを調査して
コマンドラインでの使い方
Skill ディレクトリに入った後、スクリプトを直接実行することもできます。
# モデルを検索
python scripts/AiHubMixAPI.py list --limit 20
python scripts/AiHubMixAPI.py report gemini
python scripts/AiHubMixAPI.py compare <model-a> <model-b>
# 能力別に候補モデルを探す
python scripts/AiHubMixAPI.py candidates --capability vision
python scripts/AiHubMixAPI.py candidates --capability image-gen
python scripts/AiHubMixAPI.py candidates --capability rerank
# 現在のアカウントで呼び出せる候補だけを表示。ログイン済みの aihubmix CLI が必要です
python scripts/AiHubMixAPI.py candidates --capability vision --mine
--lang zh を追加するか、次を設定します。
能力早見表
| 能力 | 推奨コマンド |
|---|
| モデル一覧を見る | list |
| モデルまたは系列を検索 | get <model-id> / report <query> |
| 複数モデルを比較 | compare <model-a> <model-b> ... |
| 能力で選定 | candidates --capability <capability> |
| 呼び出せるモデルだけ表示 | candidates --capability <capability> --mine |
| API Key を検証 | doctor --model <model-id> |
| 画像入力を検証 | doctor --model <model-id> --image |
| OpenAI 互換例を生成 | example chat --model <model-id> |
| Anthropic 互換例を生成 | example messages --model <model-id> |
| エラーを調査 | troubleshoot --status <code> --endpoint <path> --model <model-id> |
よくある質問
インストール後に Agent が自動起動しない
Agent ごとに Skill の起動ルールは異なります。まず /AiHubMixAPI を明示的に呼び出すか、「AIHubMix」「モデル」「Base URL」「API Key」「エラーコード」などのキーワードを含めて、より直接的に説明してください。
公開モデル一覧にはあるのに、自分の Key では呼び出せない
公開モデル一覧は、そのモデルがプラットフォーム上に存在することだけを示します。現在のアカウントに権限や残高があるとは限りません。aihubmix models list または candidates --mine で実際の呼び出し可能範囲を確認し、doctor --model <model-id> で実測してください。
いつ aihubmix CLI が必要ですか
公開情報だけを確認する場合は不要です。残高、Key 管理、呼び出し可能モデル、--mine フィルタなど、アカウント関連の機能を使う場合は CLI のインストールとログインが必要です。
API Key は漏れませんか
Skill のスクリプトはシークレットを脱敏します。それでも、実際の Key をリポジトリファイル、Issue、PR 説明、チャットログに書き込まないでください。ローカル検証では環境変数を使用してください。
関連リソース
