GET /v1/models

Tagastab kõik lubatud mudelid, mis on saadaval autentitud API võtmele. Hinnad on kümnendstringid USA dollarites miljoni märgi kohta.

Autentimine

Authorization: Bearer mg_live_...

x-api-key: mg_live_... aktsepteeritakse ka.

Võtmed olekuga active või frozen võib lugeda mudelikataloogi ja nende võtmepõhiseid hindu. Külmutatud võti jääb järelduste lõpp-punktide ja muude konto metaandmete lõpp-punktide jaoks blokeerituks, mis nõuavad aktiivset võtit.

Taotlus

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

Vastus

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

Hinnaväljad

• cost on tegelik Model Gate'i määr, mida kasutatakse konto saldo debiteerimiseks.
• official_cost on salvestatud ametlik pakkuja kataloogi hind.
• usage_cost on efektiivne määr, mida kasutatakse ainult lähtestatavate API-võtme ja rühma kasutuspiirangute jaoks.
• usage_pricing tuvastab autentitud võtme aluse, kordaja ja pärimisallika.
• Kui konto arveldusmallil on partii koefitsient, mis erineb 1, batch_cost näitab Claude/OpenAI-ga ühilduvate partiitoodete tegelikke tegelikke hindu ja batch_pricing.multiplier identifitseerib täiendava Model Gate koefitsiendi. Need tingimuslikud väljad jäetakse välja, kui koefitsient on 1. Native async=true ei kasuta seda koefitsienti.

Sest official_price, igaüks kuvatakse usage_cost määr on official_cost × multiplier. Sest user_price, see on cost × multiplier. Need on miljonimärgised kataloogihinnad. Päringu lõplik lahendamine arvutab esmalt välja ja ümardab valitud põhitaotluse summa 10 kümnendkohani, seejärel rakendab kordaja ja ümardab tulemuse 10 kümnendkohani.

Mudelipiirangu väljad

• context_window on kliendile suunatud kontekstiakna väärtus ja on praegu võrdne context_length.
• max_input_tokens on konfigureeritud maksimaalne sisendmärgi väärtus, kui see on teada.
• max_output_tokens on konfigureeritud maksimaalne väljundmärgi väärtus, kui see on teada.
• max_completion_tokens on lõpetamislimiidi ühilduvusväli, mida kasutavad pakkuja-stiilis mudeli metaandmed.
• Numbriline väärtus 0 tähendab, et Model Gate'il pole selle limiidi jaoks konfigureeritud väärtust. Valikulise käsitsi piirangu alistamisega kliendid peaksid jätma selle seadistuse määramata, mitte ravima 0 tegeliku mudelipiiranguna või mõne muu väärtuse arvamisena.

Autentitud /models kuvatakse ka leht Kontekst, Maksimaalne sisendja Maksimaalne väljund teadaolevate nullist erinevate väärtuste jaoks, nii et tavakasutajad ei pea API-lt päringuid tegema ainult selleks, et kopeerida need piirangud kliendi konfiguratsiooni.

Vead

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