GET /v1/models

認証された API キーで使用できるすべての有効なモデルを返します。価格は、100 万トークンあたりの USD 単位の 10 進数の文字列です。

認証

Authorization: Bearer mg_live_...

x-api-key: mg_live_... も受け付けております。

ステータス付きのキー active または frozen モデルのカタログとそのキー固有の価格を読むことができます。凍結されたキーは、推論エンドポイントや、アクティブなキーを必要とする他のアカウント メタデータ エンドポイントからブロックされたままになります。

リクエスト

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

応答

{
  "object": "list",
  "data": [
    {
      "id": "claude-opus-4.7",
      "object": "model",
      "owned_by": "anthropic",
      "display_name": "Claude Opus 4.7",
      "aliases": ["ch-47"],
      "currency": "USD",
      "pricing_unit": "per_1m_tokens",
      "cost": {
        "input": "0.2",
        "output": "1",
        "cache_read": "0.02",
        "cache_write": "0.25",
        "reasoning": "1"
      },
      "official_cost": {
        "input": "1",
        "output": "5",
        "cache_read": "0.1",
        "cache_write": "1.25",
        "reasoning": "5"
      },
      "usage_cost": {
        "input": "10",
        "output": "50",
        "cache_read": "1",
        "cache_write": "12.5",
        "reasoning": "50"
      },
      "usage_pricing": {
        "basis": "official_price",
        "multiplier": "10",
        "inherited_from": "key"
      },
      "batch_cost": {
        "input": "0.1",
        "output": "0.5",
        "cache_read": "0.01",
        "cache_write": "0.125",
        "reasoning": "0.5"
      },
      "batch_pricing": {
        "multiplier": "0.5",
        "applies_to": "claude_openai_compat_batches"
      },
      "context_length": 200000,
      "context_window": 200000,
      "max_input_tokens": 180000,
      "max_output_tokens": 20000,
      "max_completion_tokens": 20000,
      "supports_streaming": true,
      "supports_tools": true,
      "supports_vision": true
    }
  ]
}

価格フィールド

• cost 口座残高の引き落としに使用される実際のモデル ゲート レートです。
• official_cost は、保存された公式プロバイダーのカタログ料金です。
• usage_cost は、リセット可能な API キーとグループの使用制限にのみ使用される実効レートです。
• usage_pricing 認証されたキーの基礎、乗数、および継承元を識別します。
• アカウント請求テンプレートに異なるバッチ係数がある場合 1、 batch_cost Claude/OpenAI 互換のバッチアイテムの実効レートを示します。 batch_pricing.multiplier 追加のモデル ゲート係数を特定します。係数が次の場合、これらの条件フィールドは省略されます。 1。ネイティブ async=true はこの係数を使用しません。

のために official_price、それぞれ表示されます usage_cost 率は official_cost × multiplier。のために user_price、それは cost × multiplier。これらは、100 万トークンあたりのカタログ レートです。最終リクエスト決済では、まず選択された基本リクエスト金額を計算して小数点以下 10 桁に四捨五入し、次に乗数を適用して結果を小数点以下 10 桁に四捨五入します。

モデル制限フィールド

• context_window クライアント側のコンテキスト ウィンドウの値であり、現在は次と等しい context_length。
• max_input_tokens 既知の場合に設定された最大入力トークン値です。
• max_output_tokens 既知の場合に設定された最大出力トークン値です。
• max_completion_tokens プロバイダー スタイルのモデル メタデータで使用される完了制限互換性フィールドです。
• の数値 0 は、Model Gate にその制限値が構成されていないことを意味します。オプションの手動制限オーバーライドを持つクライアントは、処理せずにその設定を未設定のままにしておく必要があります。 0 実際のモデルの制限として使用するか、別の値を推測します。

認証された /models ページも表示されます コンテクスト、 最大入力、 そして 最大出力 したがって、一般のユーザーは、これらの制限をクライアント構成にコピーするためだけに API をクエリする必要はありません。

エラー

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "missing API key"
  }
}