ひとことで始める
次の一文を、お使いの AI Agent に送信してください:agents.md は Agent が直接実行できる形式で書かれた連携ガイドです。API Key の確認、リアルタイムカタログからのモデル選択、プロトコルに応じた呼び出し、エンドツーエンドの検証までを含み、トラブルシューティング表も収録しています。
エントリ一覧
モデル別 llms.txt
各モデルには、価格、検証済みの機能一覧、対応プロトコルエンドポイント、実行可能なサンプルを含む機械可読な呼び出しガイドが用意されています:llms.txt タブから対応ファイルを直接開けます。検証が完了していないモデルの場合は、リアルタイムカタログとパラメータ schema を案内するガイドドキュメントが返され、未検証の機能に関する記述は含まれません。
Playground Skill
Playground の機能(モデル試用、パラメータ調整、同一プロンプトでの比較、画像・動画生成、ディープリンクの受け渡し)を Agent に渡せます:/.well-known/skills/aihubmix-playground/SKILL.md でも公開されており、GitHub リポジトリ から npx skills add AIhubmix/skills でインストールすることもできます。API 連携やインテグレーションの用途には AIHubMix API Skill をご利用ください。
Playground ディープリンク
Agent は直接アクセスできるリンクを生成でき、ユーザーはブラウザで設定済みの Playground セッションをそのまま引き継げます:- 複数モデル比較:
https://playground.aihubmix.com/?models=gemini-3.7-flash,claude-opus-4-1(最大 6 件) - 設定の直接受け渡し:
https://playground.aihubmix.com/?config=<base64url エンコードされた JSON>。JSON の形式は{"model": "...", "proto": "chat", "params": {...}, "system": "...", "draft": "..."}で、draftは入力欄に事前入力されますが送信はされません
コード生成
npm パッケージ@aihubmix/codegen は、4 プロトコル・7 言語のプログラマティックなコード生成を提供し、構築されるリクエストボディは Playground が実際に送信するものと一致します。@aihubmix/model-schema はパラメータ schema を codegen の入力形式に変換します。
よくある質問
Agent はどうやって連携の成功を検証しますか?
agents.md にはエンドツーエンドの検証手順が含まれています。厳密な応答を要求する最小リクエストを送信し、レスポンス本文とモデルのエコーを確認します。HTTP 200 は成功と同義ではなく、レスポンス内容の確認が必要です。
呼び出しに必要な認証情報は何ですか?
AIHubMix API Key が 1 つ必要です。環境変数AIHUBMIX_API_KEY で渡し、コンソール で作成できます。Key をコード、スクリプト、会話に書き込まないでください。
モデル別 llms.txt はどのモデルをカバーしていますか?
検証済みモデルには完全なドキュメント(機能一覧は公式の検証データに基づく)が返され、それ以外のモデルにはガイドドキュメントが返されます。カバー範囲は検証の進行に伴って拡大します。MCP への対応状況はどうなっていますか?
MCP エンドポイントは現在、画像生成サービスを提供しており、機能拡張を進めています。現段階では Skill と agents.md による連携を優先することをおすすめします。更新日:2026-08-20