プラットフォーム API
モデル管理 API
本 API ドキュメントでは、モデル管理インターフェースについて、新バージョンと旧バージョンの機能、リクエスト例、パラメータ説明、レスポンス形式を詳しく説明します。
GET
モデル管理 API
新バージョンAPI
モデル情報の取得
エンドポイント:GET https://aihubmix.com/api/v1/models
機能説明:利用可能なすべてのモデルの詳細情報を取得します。
モデルオブジェクトのフィールド説明
基本情報
モデルタイプ。カンマ区切りで、サポートされる値:
llm(大規模言語モデル)、image_generation(画像生成モデル)、video(動画生成モデル)、tts(音声合成モデル)、stt(音声テキスト変換モデル)、embedding(埋め込みモデル)、rerank(リランキングモデル)、ocr(文字認識モデル)、search(検索モデル)、3d(3D 生成モデル)サポートされる機能。カンマ区切りで、サポートされる値:
thinking(思考推論をサポート)、tools(ツール呼び出しをサポート)、function_calling(関数呼び出しをサポート)、web(検索をサポート)、deepsearch(ディープサーチをサポート)、long_context(長文コンテキストモデル)、structured_outputs(構造化出力)サポートされる出力モダリティ。カンマ区切りで、サポートされる値:
text(テキスト)、image(画像)、audio(音声)、video(動画)。省略可能なフィールドで、欠落は未記載を意味しますモデルが利用可能なインターフェースプロトコル。カンマ区切りで、サポートされる値:
chat_completions(Chat Completions インターフェース)、responses(Responses インターフェース)、claude_api(Claude Messages インターフェース)、gemini_api(Gemini インターフェース)。空の場合は未記載を意味します価格情報
段階別価格の配列で、省略可能なフィールドです。各要素は
tier オブジェクト(type は context 固定、size はコンテキストトークン数のしきい値)と、その段階の input、output、cache_read、cache_write 価格を含みます。リクエストのコンテキスト長が size を超えると、その段階の価格で課金されます。トップレベルの input、output などのフィールドはデフォルト段階の価格です推論とツール機能
思考レベル設定の配列で、省略可能なフィールドです。各項目は
type を含み、サポートされる値:toggle(思考のオン / オフ切り替えが可能)、effort(レベル指定で制御、values に選択可能なレベル、default にデフォルトレベルを列挙)、budget_tokens(トークン予算で制御)各インターフェースプロトコルにおける思考内容の返却形式です。省略可能なフィールドで、欠落は未収録を意味します。キーはプロトコル名(
anthropic.messages、openai.chat_completions、openai.responses、google.gemini)で、値は true(そのプロトコルで思考内容を返却可能)または {"field": "reasoning_content"}(思考内容はそのフィールドで返却される)です。実際に呼び出すプロトコルに対応するキーを参照してくださいバリアントとライフサイクル
親モデルの ID で、省略可能なフィールドです。存在する場合、現在の
model_id は親モデルと同一のモデルであり、プラットフォーム内の価格段階またはプリセットのみが異なることを意味しますバリアントの種類。
variant_of とペアで出現します。サポートされる値:pricing-tier(価格段階)、channel-tier(接続段階)、mode-preset(モードプリセット)、deprecated-alias(廃止済みエイリアス)モデルのライフサイクル段階で、常に返却されます。サポートされる値:
active(正常にサービス提供中)、deprecated(提供終了が告知済み、引き続き呼び出し可能)。サービスを停止したモデルは本 API のレスポンスに含まれません期間限定オファー
オファー時間ルールの種類。サポートされる値:
absolute(絶対時間区間、absolute オブジェクトの start、end を参照)、daily(毎日の固定時間帯、daily.ranges を参照)、weekly(毎週の固定時間帯、weekly 配列の weekdays と ranges を参照。weekdays は ISO 8601 に基づき、月曜が 1、日曜が 7)リクエスト例
リクエストパラメータ説明(絞り込みに使用可能)
モデルタイプ。サポートされる値:
llm(大規模言語モデル)、image_generation(画像生成モデル)、video(動画生成モデル)、tts(音声合成モデル)、stt(音声テキスト変換モデル)、embedding(埋め込みモデル)、rerank(リランキングモデル)、ocr(文字認識モデル)、search(検索モデル)、3d(3D 生成モデル)モデルの機能。サポートされる値:
thinking(思考推論をサポート)、tools(ツール呼び出しをサポート)、function_calling(関数呼び出しをサポート)、web(検索をサポート)、deepsearch(ディープサーチをサポート)、long_context(長文コンテキストモデル)、structured_outputs(構造化出力)。複数機能の指定が可能です(カンマ区切り)インターフェースプロトコルによる絞り込み。サポートされる値:
chat_completions、responses、claude_api、gemini_api。複数値の指定が可能です(カンマ区切り)ソートフィールド。サポートされる値:
•
•
•
•
•
model_ratio:コストパフォーマンス順にソート•
context_length:コンテキスト長順にソート•
coding:プログラミング向けモデルを優先してソート•
order:デフォルト順にソートレスポンス成功例
ユースケース例
説明:プログラミング向けモデルのスマートソートを使用すると、システムは coding タグを含むモデルを優先的に表示し、その他のモデルはデフォルト順に並びます。
パフォーマンス最適化
キャッシュメカニズム
- キャッシュ戦略:HTTP キャッシュ、キャッシュ時間は 300 秒(5 分)
- キャッシュ制御:
Cache-Control: private, max-age=300, stale-while-revalidate=300 - コンテンツ検証:ETag によるコンテンツハッシュ検証をサポート
キャッシュ使用例
コンテンツが更新されていない場合、サーバーは 304 Not Modified ステータスコードを返します。
エラー処理
重要な説明
- データの完全性:この API は条件に一致するすべてのモデルを返し、ページネーション処理を行いません
- タイプ互換性:新旧タイプ識別子の自動マッピングをサポート
t2t↔llmt2i↔image_generationt2v↔videoreranking↔rerank
- 絞り込みロジック:複数の絞り込み条件は論理積(AND)の関係です
- ソートルール:ソート方法が指定されていない場合、システムのデフォルト順で並びます
- ライフサイクル:
retire_stageがdeprecatedのモデルは引き続き正常に呼び出せます。successor_model、retired_atフィールドを参考に、早めに移行を計画することを推奨します。サービスを停止したモデルはレスポンスのリストに含まれません - 省略可能なフィールド:省略可能と記載されたフィールドの欠落は、その情報が未記載または未収録であることを意味し、モデルが対応する機能を備えていないことを意味するものではありません
旧バージョンAPI
⚠️ 注意:以下は旧バージョンの API です。より良いパフォーマンスと機能を得るために、新バージョンの API を優先して使用することを推奨します。
モデルリストの取得
エンドポイント(Endpoint):GET /v1/models
- ユーザーがログインしている場合はユーザーグループ下の利用可能リストを取得し、ユーザーがログインしていない場合は default グループ下の利用可能リストを取得します。
- header に Authorization フィールドがある場合は、key に対応する token 下で設定されたモデルリストを照会します。
レスポンス結果
レスポンスデータ構造
ステータスコード 200モデル情報の取得
エンドポイント(Endpoint):GET /v1/models/:model
リクエストパラメータ
レスポンス例:
レスポンス結果
レスポンスデータ構造
ステータスコード 200最終更新日:2026-09-18