Skills

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、モデル権限のどれが原因か確認して。

Agent が自動で Skill を起動しない場合は、明示的に呼び出します。

/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 を追加するか、次を設定します。

export AIHUBMIX_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 説明、チャットログに書き込まないでください。ローカル検証では環境変数を使用してください。

はじめに

コンソールガイド

エンタープライズとチーム

ゲートウェイ機能

モデル機能

プロトコルリファレンス

プラットフォーム管理

利用シーン

前提条件

インストール

方法 1: Agent にインストールしてもらう

方法 2: 手動インストール

任意: AIHubMix CLI をインストール

使い方

コマンドラインでの使い方

能力早見表

よくある質問

インストール後に Agent が自動起動しない

公開モデル一覧にはあるのに、自分の Key では呼び出せない

いつ `aihubmix` CLI が必要ですか

API Key は漏れませんか

関連リソース

​利用シーン

​前提条件

​インストール

​方法 1: Agent にインストールしてもらう

​方法 2: 手動インストール

​任意: AIHubMix CLI をインストール

​使い方

​コマンドラインでの使い方

​能力早見表

​よくある質問

​インストール後に Agent が自動起動しない

​公開モデル一覧にはあるのに、自分の Key では呼び出せない

​いつ aihubmix CLI が必要ですか

​API Key は漏れませんか

​関連リソース

利用シーン

前提条件

インストール

方法 1: Agent にインストールしてもらう

方法 2: 手動インストール

任意: AIHubMix CLI をインストール

使い方

コマンドラインでの使い方

能力早見表

よくある質問

インストール後に Agent が自動起動しない

公開モデル一覧にはあるのに、自分の Key では呼び出せない

いつ `aihubmix` CLI が必要ですか

API Key は漏れませんか

関連リソース