GET /v1/models

Vráti každý povolený model dostupný pre overený kľúč API. Ceny sú desatinné reťazce v USD za jeden milión tokenov.

Autentifikácia

Authorization: Bearer mg_live_...

x-api-key: mg_live_... je tiež akceptovaný.

Kľúče so stavom active alebo frozen si môžete prečítať katalóg modelov a ich ceny špecifické pre kľúč. Zamrznutý kľúč zostáva zablokovaný z koncových bodov odvodzovania a z iných koncových bodov metadát účtu, ktoré vyžadujú aktívny kľúč.

Žiadosť

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

odpoveď

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

Cenové polia

• cost je skutočná sadzba modelovej brány použitá na odpísanie zostatku na účte.
• official_cost je uložená oficiálna katalógová sadzba poskytovateľa.
• usage_cost je efektívna rýchlosť používaná len pre resetovateľné limity API kľúča a skupiny.
• usage_pricing identifikuje základ, násobiteľ a zdroj dedičstva pre overený kľúč.
• Keď má šablóna fakturácie účtu dávkový koeficient odlišný od 1, batch_cost zobrazuje skutočné skutočné sadzby pre dávkové položky kompatibilné s Claude/OpenAI a batch_pricing.multiplier identifikuje dodatočný koeficient Model Gate. Tieto podmienené polia sú vynechané, ak je koeficient 1. Natívne async=true tento koeficient nepoužíva.

Pre official_price, každý zobrazený usage_cost sadzba je official_cost × multiplier. Pre user_price, to je cost × multiplier. Toto sú katalógové sadzby za milión tokenov. Konečné zúčtovanie žiadosti najprv vypočíta a zaokrúhli vybranú základnú sumu požiadavky na 10 desatinných miest, potom použije násobiteľ a zaokrúhli výsledok na 10 desatinných miest.

Modelové limitné polia

• context_window je hodnota kontextového okna pre klienta a momentálne sa rovná context_length.
• max_input_tokens je nakonfigurovaná maximálna hodnota vstupného tokenu, ak je známa.
• max_output_tokens je nakonfigurovaná maximálna hodnota výstupného tokenu, ak je známa.
• max_completion_tokens je pole kompatibility limitu dokončenia používané metaúdajmi modelu v štýle poskytovateľa.
• Číselná hodnota 0 znamená, že Model Gate nemá pre tento limit nakonfigurovanú hodnotu. Klienti s voliteľným manuálnym prepísaním limitov by mali toto nastavenie radšej ponechať nenastavené, než liečiť 0 ako skutočný limit modelu alebo hádanie inej hodnoty.

Overené /models zobrazí sa aj stránka Kontext, Max vstupa Maximálny výkon pre známe nenulové hodnoty, takže bežní užívatelia sa nemusia pýtať API len na skopírovanie týchto limitov do konfigurácie klienta.

Chyby

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