モデル管理 API

GET

api

models

モデル管理 API

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

新バージョンAPI

モデル情報の取得

エンドポイント：GET https://aihubmix.com/api/v1/models 機能説明：利用可能なすべてのモデルの詳細情報を取得します。

モデルオブジェクトのフィールド説明

基本情報

array

モデル情報リストの配列

string

モデルの一意な識別子で、API 呼び出し時に使用する model パラメータの値です

string

モデルの表示名

integer

プラットフォーム内でのモデル開発者の番号です。リクエストパラメータ developer_id と組み合わせて絞り込みに使用できます

string

モデルの機能説明（英語）

string

モデルベンダーの識別子（例：openai、anthropic、zhipu）。developer_id とは別系統の番号です。省略可能なフィールドで、欠落は未収録を意味します

string

モデルタイプ。カンマ区切りで、サポートされる値：llm（大規模言語モデル）、image_generation（画像生成モデル）、video（動画生成モデル）、tts（音声合成モデル）、stt（音声テキスト変換モデル）、embedding（埋め込みモデル）、rerank（リランキングモデル）、ocr（文字認識モデル）、search（検索モデル）、3d（3D 生成モデル）

string

サポートされる機能。カンマ区切りで、サポートされる値：thinking（思考推論をサポート）、tools（ツール呼び出しをサポート）、function_calling（関数呼び出しをサポート）、web（検索をサポート）、deepsearch（ディープサーチをサポート）、long_context（長文コンテキストモデル）、structured_outputs（構造化出力）

string

サポートされる入力モダリティ。カンマ区切りで、サポートされる値：text（テキスト）、image（画像）、audio（音声）、video（動画）、pdf

string

サポートされる出力モダリティ。カンマ区切りで、サポートされる値：text（テキスト）、image（画像）、audio（音声）、video（動画）。省略可能なフィールドで、欠落は未記載を意味します

string

モデルが利用可能なインターフェースプロトコル。カンマ区切りで、サポートされる値：chat_completions（Chat Completions インターフェース）、responses（Responses インターフェース）、claude_api（Claude Messages インターフェース）、gemini_api（Gemini インターフェース）。空の場合は未記載を意味します

integer

最大出力トークン数

integer

コンテキストウィンドウのサイズ（最大入力トークン数）

string

モデルのリリース日。形式は YYYY-MM-DD または YYYY-MM です。省略可能なフィールドで、欠落は未収録を意味します

string

モデルの最終更新日。インプレースアップグレードの記録がない場合は release_date と同じ値になります。省略可能なフィールドです

boolean

モデルの重みが公開されており、自身でデプロイ可能かどうか。false は公式が重みを公開しないと明言していることを意味します。省略可能なフィールドで、欠落は未収録を意味します

boolean

プラットフォームがこのモデルのリクエストパラメータ構造の確認を完了しているかどうか

価格情報

object

価格情報オブジェクト。すべての価格の単位は 100 万（1M）トークンあたりの米ドルです

number

入力トークン価格（米ドル / 1M トークン）

number

出力トークン価格（米ドル / 1M トークン）

number

キャッシュ読み取り価格（米ドル / 1M トークン、省略可能なフィールド）

number

キャッシュ書き込み価格（米ドル / 1M トークン、省略可能なフィールド）

array

段階別価格の配列で、省略可能なフィールドです。各要素は tier オブジェクト（type は context 固定、size はコンテキストトークン数のしきい値）と、その段階の input、output、cache_read、cache_write 価格を含みます。リクエストのコンテキスト長が size を超えると、その段階の価格で課金されます。トップレベルの input、output などのフィールドはデフォルト段階の価格です

推論とツール機能

boolean

思考推論機能を備えているかどうか。features から正規化されたブール値です。省略可能なフィールドで、欠落は未記載を意味し、非対応を意味するものではありません

boolean

ツール呼び出しをサポートしているかどうか。features から正規化されたブール値です。省略可能なフィールドで、欠落は未記載を意味し、非対応を意味するものではありません

array

思考レベル設定の配列で、省略可能なフィールドです。各項目は type を含み、サポートされる値：toggle（思考のオン / オフ切り替えが可能）、effort（レベル指定で制御、values に選択可能なレベル、default にデフォルトレベルを列挙）、budget_tokens（トークン予算で制御）

object

各インターフェースプロトコルにおける思考内容の返却形式です。省略可能なフィールドで、欠落は未収録を意味します。キーはプロトコル名（anthropic.messages、openai.chat_completions、openai.responses、google.gemini）で、値は true（そのプロトコルで思考内容を返却可能）または {"field": "reasoning_content"}（思考内容はそのフィールドで返却される）です。実際に呼び出すプロトコルに対応するキーを参照してください

バリアントとライフサイクル

string

親モデルの ID で、省略可能なフィールドです。存在する場合、現在の model_id は親モデルと同一のモデルであり、プラットフォーム内の価格段階またはプリセットのみが異なることを意味します

string

バリアントの種類。variant_of とペアで出現します。サポートされる値：pricing-tier（価格段階）、channel-tier（接続段階）、mode-preset（モードプリセット）、deprecated-alias（廃止済みエイリアス）

string

モデルのライフサイクル段階で、常に返却されます。サポートされる値：active（正常にサービス提供中）、deprecated（提供終了が告知済み、引き続き呼び出し可能）。サービスを停止したモデルは本 API のレスポンスに含まれません

string

提供終了の告知日時（ISO 8601 形式）。deprecated 段階でのみ返却されます

string

サービス停止の予定日時（ISO 8601 形式）。省略可能なフィールドで、deprecated 段階でのみ返却される場合があります

string

移行を推奨する代替モデルの ID。省略可能なフィールドで、deprecated 段階でのみ返却される場合があります

期間限定オファー

object

期間限定オファー情報で、省略可能なフィールドです。オファーがない場合は欠落します

string

オファーキャンペーン名

integer

割引率（パーセント）。例：10 は 10% オフを意味します

string

オファー時間ルールの種類。サポートされる値：absolute（絶対時間区間、absolute オブジェクトの start、end を参照）、daily（毎日の固定時間帯、daily.ranges を参照）、weekly（毎週の固定時間帯、weekly 配列の weekdays と ranges を参照。weekdays は ISO 8601 に基づき、月曜が 1、日曜が 7）

リクエスト例

import requests

# 接口地址
url = "https://aihubmix.com/api/v1/models"

response = requests.get(url)
print(response.json())

params = {
    "type": "llm",                   
	"modalities": "text",
	"model": "gpt-5",
	"features": "thinking",
    "sort_by": "context_length",
    "sort_order": "desc"    
}
response = requests.get(url, params=params)
print(response.json())

fetch('https://aihubmix.com/api/v1/models')
  .then(response => response.json())
  .then(data => console.log(data));

const params = new URLSearchParams({
  type: 'llm',
  modalities: 'text',
  model: 'gpt-5',
  features: 'thinking',
  sort_by: 'context_length',
  sort_order: 'desc' 
});

fetch(`https://aihubmix.com/api/v1/models?${params}`)
  .then(response => response.json())
  .then(data => console.log(data));

curl -X GET "https://aihubmix.com/api/v1/models"

curl -X GET "https://aihubmix.com/api/v1/models?type=llm&modalities=text&model=gpt-5&features=thinking&sort_by=context_length&sort_order=desc"

リクエストパラメータ説明（絞り込みに使用可能）

string

モデルタイプ。サポートされる値：llm（大規模言語モデル）、image_generation（画像生成モデル）、video（動画生成モデル）、tts（音声合成モデル）、stt（音声テキスト変換モデル）、embedding（埋め込みモデル）、rerank（リランキングモデル）、ocr（文字認識モデル）、search（検索モデル）、3d（3D 生成モデル）

string

入力モダリティ。サポートされる値：text（テキスト）、image（画像）、audio（音声）、video（動画）、pdf。複数モダリティの指定が可能です（カンマ区切り）

string

モデル名のあいまい検索（部分一致をサポート）

string

モデルの機能。サポートされる値：thinking（思考推論をサポート）、tools（ツール呼び出しをサポート）、function_calling（関数呼び出しをサポート）、web（検索をサポート）、deepsearch（ディープサーチをサポート）、long_context（長文コンテキストモデル）、structured_outputs（構造化出力）。複数機能の指定が可能です（カンマ区切り）

string

インターフェースプロトコルによる絞り込み。サポートされる値：chat_completions、responses、claude_api、gemini_api。複数値の指定が可能です（カンマ区切り）

integer

モデル開発者番号による絞り込み。番号はレスポンスフィールド developer_id を参照してください

string

モデルタグによる絞り込み。例：coding（プログラミング向けモデル）

boolean

true を指定すると、プラットフォームがリクエストパラメータ構造の確認を完了したモデル（レスポンスフィールド schema_checked が true のモデル）のみを返します

string

ソートフィールド。サポートされる値：
• model_ratio：コストパフォーマンス順にソート
• context_length：コンテキスト長順にソート
• coding：プログラミング向けモデルを優先してソート
• order：デフォルト順にソート

string

ソート方向。サポートされる値：
• asc（昇順）
• desc（降順）

レスポンス成功例

{
    "data": [
        {
            "model_id": "gpt-6-astra",
            "model_name": "GPT 6 Astra",
            "developer_id": 12,
            "desc": "GPT-6 Astra is OpenAI's newest and most intelligent model, with industry-leading performance in computer operations, web browsing, software engineering, scientific research, and professional work.",
            "pricing": {
                "cache_read": 1,
                "cache_write": 12.5,
                "input": 10,
                "output": 50,
                "tiers": [
                    {
                        "cache_read": 2,
                        "cache_write": 25,
                        "input": 20,
                        "output": 75,
                        "tier": {
                            "size": 272000,
                            "type": "context"
                        }
                    }
                ]
            },
            "types": "llm",
            "features": "tools,thinking,structured_outputs",
            "input_modalities": "text,image",
            "endpoints": "chat_completions,responses",
            "max_output": 128000,
            "context_length": 1050000,
            "release_date": "2026-09-05",
            "last_updated": "2026-09-05",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "effort",
                    "values": ["low", "medium", "high", "xhigh", "max"],
                    "default": "medium"
                }
            ],
            "interleaved": {
                "openai.responses": true
            },
            "vendor": "openai",
            "open_weights": false,
            "schema_checked": false,
            "retire_stage": "active"
        },
        {
            "model_id": "glm-5.3",
            "model_name": "GLM 5.3",
            "developer_id": 5,
            "desc": "GLM-5.3 is Z.AI's coding and agentic reasoning model, built for complex software engineering, long-running agent tasks, vulnerability analysis, and other demanding workloads.",
            "pricing": {
                "cache_read": 0.2817,
                "input": 1.1268,
                "output": 3.9438
            },
            "types": "llm",
            "features": "thinking,tools,function_calling,structured_outputs",
            "input_modalities": "text",
            "endpoints": "",
            "max_output": 131072,
            "context_length": 1048576,
            "release_date": "2026-08-14",
            "last_updated": "2026-08-14",
            "output_modalities": "text",
            "reasoning": true,
            "tool_call": true,
            "reasoning_options": [
                {
                    "type": "toggle"
                },
                {
                    "type": "effort",
                    "values": ["low", "high", "max"],
                    "default": "max"
                }
            ],
            "interleaved": {
                "anthropic.messages": true,
                "openai.chat_completions": {
                    "field": "reasoning_content"
                }
            },
            "vendor": "zhipu",
            "open_weights": true,
            "schema_checked": false,
            "promotion": {
                "name": "GLM-5.3 limited-time special offer",
                "off_percent": 10,
                "time_type": "daily",
                "daily": {
                    "ranges": ["00:00-23:59"]
                }
            },
            "retire_stage": "active"
        }
    ],
    "message": "",
    "success": true
}

ユースケース例

GET https://aihubmix.com/api/v1/models?type=llm

GET https://aihubmix.com/api/v1/models?tag=coding&sort_by=context_length&sort_order=desc

GET https://aihubmix.com/api/v1/models?model=gpt-5

GET https://aihubmix.com/api/v1/models?type=llm&modalities=text,image&features=function_calling&sort_by=model_ratio&sort_order=asc

GET https://aihubmix.com/api/v1/models?sort_by=coding

GET https://aihubmix.com/api/v1/models?endpoints=claude_api

GET https://aihubmix.com/api/v1/models?schema_checked=true

説明：プログラミング向けモデルのスマートソートを使用すると、システムは coding タグを含むモデルを優先的に表示し、その他のモデルはデフォルト順に並びます。

パフォーマンス最適化

キャッシュメカニズム

キャッシュ戦略：HTTP キャッシュ、キャッシュ時間は 300 秒（5 分）
キャッシュ制御：Cache-Control: private, max-age=300, stale-while-revalidate=300
コンテンツ検証：ETag によるコンテンツハッシュ検証をサポート

キャッシュ使用例

# 使用ETag进行条件请求
curl -H "If-None-Match: \"abc123...\"" \
     https://aihubmix.com/api/v1/models

コンテンツが更新されていない場合、サーバーは 304 Not Modified ステータスコードを返します。

エラー処理

{
  "success": false,
  "message": "请求参数格式错误"
}

{
  "success": false,
  "message": "服务器内部错误，请稍后重试"
}

重要な説明

データの完全性：この API は条件に一致するすべてのモデルを返し、ページネーション処理を行いません
タイプ互換性：新旧タイプ識別子の自動マッピングをサポート
- t2t ↔ llm
- t2i ↔ image_generation
- t2v ↔ video
- reranking ↔ rerank
絞り込みロジック：複数の絞り込み条件は論理積（AND）の関係です
ソートルール：ソート方法が指定されていない場合、システムのデフォルト順で並びます
ライフサイクル：retire_stage が deprecated のモデルは引き続き正常に呼び出せます。successor_model、retired_at フィールドを参考に、早めに移行を計画することを推奨します。サービスを停止したモデルはレスポンスのリストに含まれません
省略可能なフィールド：省略可能と記載されたフィールドの欠落は、その情報が未記載または未収録であることを意味し、モデルが対応する機能を備えていないことを意味するものではありません

旧バージョンAPI

⚠️ 注意：以下は旧バージョンの API です。より良いパフォーマンスと機能を得るために、新バージョンの API を優先して使用することを推奨します。

モデルリストの取得

エンドポイント（Endpoint）： GET /v1/models

ユーザーがログインしている場合はユーザーグループ下の利用可能リストを取得し、ユーザーがログインしていない場合は default グループ下の利用可能リストを取得します。
header に Authorization フィールドがある場合は、key に対応する token 下で設定されたモデルリストを照会します。

レスポンス例：

{
  "data": [
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1626777600,
      "owned_by": "OpenAI",
      "permission": [
        {
          "id": "modelperm-LwHkVFn8AcMItP432fKKDIKJ",
          "object": "model_permission",
          "created": 1626777600,
          "allow_create_engine": true,
          "allow_sampling": true,
          "allow_logprobs": true,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "gpt-4o-mini",
      "parent": null
    }
  ]
}

レスポンス結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	none	Inline

レスポンスデータ構造

ステータスコード 200

名前	タイプ	必須	制約	中国語名	説明
» data	[object]	true	none		none
»» id	string	true	none	モデル ID	none
»» object	string	true	none	model	none
»» created	integer	true	none	作成時間	none
»» owned_by	string	true	none	開発者	none
»» permission	[object]¦null	true	none		none
»»» id	string	true	none		none
»»» object	string	true	none		none
»»» created	integer	true	none		none
»»» allow_create_engine	boolean	true	none		none
»»» allow_sampling	boolean	true	none		none
»»» allow_logprobs	boolean	true	none		none
»»» allow_search_indices	boolean	true	none		none
»»» allow_view	boolean	true	none		none
»»» allow_fine_tuning	boolean	true	none		none
»»» organization	string	true	none		none
»»» group	null	true	none		none
»»» is_blocking	boolean	true	none		none
»» root	string	true	none	モデル名	none
»» parent	null	true	none	親ノード	none

モデル情報の取得

エンドポイント（Endpoint）：GET /v1/models/:model

リクエストパラメータ

名前	位置	タイプ	必須	説明
model	path	string	はい	モデル ID

レスポンス例：

200 Response

{
  "id": "string",
  "object": "string",
  "created": 0,
  "owned_by": "string",
  "permission": [
    {
      "id": "string",
      "object": "string",
      "created": 0,
      "allow_create_engine": true,
      "allow_sampling": true,
      "allow_logprobs": true,
      "allow_search_indices": true,
      "allow_view": true,
      "allow_fine_tuning": true,
      "organization": "string",
      "group": null,
      "is_blocking": true
    }
  ],
  "root": "string",
  "parent": null
}

レスポンス結果

ステータスコード	ステータスコードの意味	説明	データモデル
200	OK	none	Inline

レスポンスデータ構造

ステータスコード 200

名前	タイプ	必須	制約	中国語名	説明
id	string	true	none	モデル ID	none
object	string	true	none	model	none
created	integer	true	none	作成時間	none
owned_by	string	true	none	開発者	none
permission	[object]	true	none		none
» id	string	false	none		none
» object	string	false	none		none
» created	integer	false	none		none
» allow_create_engine	boolean	false	none		none
» allow_sampling	boolean	false	none		none
» allow_logprobs	boolean	false	none		none
» allow_search_indices	boolean	false	none		none
» allow_view	boolean	false	none		none
» allow_fine_tuning	boolean	false	none		none
» organization	string	false	none		none
» group	null	false	none		none
» is_blocking	boolean	false	none		none
root	string	true	none	モデル名	none
parent	null	true	none	親ノード	none

最終更新日：2026-09-18

モデル管理 API

curl --request GET \
  --url https://aihubmix.com/api/v1/models \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {}
  ],
  "model_id": "<string>",
  "model_name": "<string>",
  "developer_id": 123,
  "desc": "<string>",
  "vendor": "<string>",
  "types": "<string>",
  "features": "<string>",
  "input_modalities": "<string>",
  "output_modalities": "<string>",
  "endpoints": "<string>",
  "max_output": 123,
  "context_length": 123,
  "release_date": "<string>",
  "last_updated": "<string>",
  "open_weights": true,
  "schema_checked": true,
  "pricing": {},
  "pricing.input": 123,
  "pricing.output": 123,
  "pricing.cache_read": 123,
  "pricing.cache_write": 123,
  "pricing.tiers": [
    {}
  ],
  "reasoning": true,
  "tool_call": true,
  "reasoning_options": [
    {}
  ],
  "interleaved": {},
  "variant_of": "<string>",
  "variant_kind": "<string>",
  "retire_stage": "<string>",
  "deprecated_at": "<string>",
  "retired_at": "<string>",
  "successor_model": "<string>",
  "promotion": {},
  "promotion.name": "<string>",
  "promotion.off_percent": 123,
  "promotion.time_type": "<string>"
}

モデルエンドポイント

プラットフォーム API

モデル管理 API

新バージョンAPI

モデル情報の取得

モデルオブジェクトのフィールド説明

基本情報

価格情報

推論とツール機能

バリアントとライフサイクル

期間限定オファー

リクエスト例

リクエストパラメータ説明（絞り込みに使用可能）

レスポンス成功例

ユースケース例

パフォーマンス最適化

キャッシュメカニズム

キャッシュ使用例

エラー処理

重要な説明

旧バージョンAPI

モデルリストの取得

レスポンス結果

レスポンスデータ構造

モデル情報の取得

リクエストパラメータ

レスポンス結果

レスポンスデータ構造

​新バージョンAPI

​モデル情報の取得

​モデルオブジェクトのフィールド説明

​基本情報

​価格情報

​推論とツール機能

​バリアントとライフサイクル

​期間限定オファー

​リクエスト例

​リクエストパラメータ説明（絞り込みに使用可能）

​レスポンス成功例

​ユースケース例

​パフォーマンス最適化

​キャッシュメカニズム

​キャッシュ使用例

​エラー処理

​重要な説明

​旧バージョンAPI

​モデルリストの取得

​レスポンス結果

​レスポンスデータ構造

​モデル情報の取得

​リクエストパラメータ

​レスポンス結果

​レスポンスデータ構造

新バージョンAPI

モデル情報の取得

モデルオブジェクトのフィールド説明

基本情報

価格情報

推論とツール機能

バリアントとライフサイクル

期間限定オファー

リクエスト例

リクエストパラメータ説明（絞り込みに使用可能）

レスポンス成功例

ユースケース例

パフォーマンス最適化

キャッシュメカニズム

キャッシュ使用例

エラー処理

重要な説明

旧バージョンAPI

モデルリストの取得

レスポンス結果

レスポンスデータ構造

モデル情報の取得

リクエストパラメータ

レスポンス結果

レスポンスデータ構造