GET /v1/models

Returnează fiecare model activat disponibil pentru cheia API autentificată. Prețurile sunt șiruri zecimale în USD pentru un milion de jetoane.

Autentificare

Authorization: Bearer mg_live_...

x-api-key: mg_live_... este de asemenea acceptat.

Chei cu stare active sau frozen pot citi catalogul de modele și prețurile specifice ale acestora. O cheie înghețată rămâne blocată de la punctele finale de inferență și de la alte puncte finale de metadate ale contului care necesită o cheie activă.

Cerere

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

Răspuns

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

Câmpurile de preț

• cost este rata actuală Model Gate utilizată pentru a debita soldul contului.
• official_cost este tariful de catalog oficial al furnizorilor salvat.
• usage_cost este rata efectivă utilizată numai pentru cheia API resetabilă și limitele de utilizare a grupului.
• usage_pricing identifică baza, multiplicatorul și sursa de moștenire pentru cheia autentificată.
• Când șablonul de facturare a contului are un coeficient de lot diferit de 1, batch_cost arată ratele efective efective pentru articolele de lot compatibile cu Claude/OpenAI și batch_pricing.multiplier identifică coeficientul suplimentar Model Gate. Aceste câmpuri condiționale sunt omise atunci când coeficientul este 1. Nativ async=true nu utilizează acest coeficient.

Pentru official_price, fiecare afișat usage_cost rata este official_cost × multiplier. Pentru user_price, este cost × multiplier. Acestea sunt tarife de catalog per milion de token. Decontarea finală a cererii mai întâi calculează și rotunjește suma de bază selectată la 10 zecimale, apoi aplică multiplicatorul și rotunjește rezultatul la 10 zecimale.

Câmpuri limită model

• context_window este valoarea ferestrei context orientată către client și este în prezent egală context_length.
• max_input_tokens este valoarea maximă configurată a jetonului de intrare atunci când este cunoscută.
• max_output_tokens este valoarea maximă configurată a jetonului de ieșire atunci când este cunoscută.
• max_completion_tokens este câmpul de compatibilitate cu limita de completare utilizat de metadatele modelului de tip furnizor.
• O valoare numerică a 0 înseamnă că Model Gate nu are o valoare configurată pentru acea limită. Clienții cu depășiri manuale opționale ale limitelor ar trebui să lase acea setare nesetata în loc să o trateze 0 ca limită reală a modelului sau ghicirea unei alte valori.

Cel autentificat /models se afișează și pagina Context, Intrare maximă, și Ieșire maximă pentru valori cunoscute diferite de zero, astfel încât utilizatorii obișnuiți nu trebuie să interogheze API-ul doar pentru a copia aceste limite într-o configurație client.

Erori

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