GET /v1/models

Retorna tots els models habilitats disponibles per a la clau de l'API autenticada. Els preus són cadenes decimals en USD per milió de fitxes.

Autenticació

Authorization: Bearer mg_live_...

x-api-key: mg_live_... també s'accepta.

Tecles amb estat active o frozen pot llegir el catàleg de models i els preus específics de les claus. Una clau congelada roman bloquejada dels punts finals d'inferència i d'altres punts finals de metadades del compte que requereixen una clau activa.

Sol·licitud

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

Resposta

{
  "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
    }
  ]
}

Camps de preu

• cost és la taxa de Model Gate real que s'utilitza per carregar el saldo del compte.
• official_cost és la tarifa de catàleg oficial de proveïdors desada.
• usage_cost és la taxa efectiva que s'utilitza només per als límits d'ús de grup i clau d'API reinicialitzables.
• usage_pricing identifica la base, el multiplicador i la font d'herència per a la clau autenticada.
• Quan la plantilla de facturació del compte té un coeficient per lots diferent de 1, batch_cost mostra les tarifes reals efectives per als articles de lot compatibles amb Claude/OpenAI i batch_pricing.multiplier identifica el coeficient addicional de Model Gate. Aquests camps condicionals s'ometen quan el coeficient és 1. Nadiu async=true no utilitza aquest coeficient.

Per official_price, cadascuna mostrada usage_cost taxa és official_cost × multiplier. Per user_price, ho és cost × multiplier. Aquestes són tarifes de catàleg per milió de testimonis. La liquidació de la sol·licitud final primer calcula i arrodoneix la quantitat de sol·licitud base seleccionada a 10 decimals, després aplica el multiplicador i arrodoneix el resultat a 10 decimals.

Camps de límit de model

• context_window és el valor de la finestra de context orientada al client i actualment és igual context_length.
• max_input_tokens és el valor màxim configurat del testimoni d'entrada quan es coneix.
• max_output_tokens és el valor màxim configurat del testimoni de sortida quan es coneix.
• max_completion_tokens és el camp de compatibilitat del límit de finalització utilitzat per les metadades del model d'estil proveïdor.
• Un valor numèric de 0 significa que Model Gate no té un valor configurat per a aquest límit. Els clients amb substitucions de límit manuals opcionals haurien de deixar aquesta configuració sense definir en lloc de tractar-la 0 com a límit real del model o endevinar un altre valor.

El autenticat /models també es mostra la pàgina Context, Entrada màxima, i Sortida màxima per a valors diferents de zero coneguts, de manera que els usuaris normals no necessiten consultar l'API només per copiar aquests límits a una configuració de client.

Errors

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