GET /v1/models

Vrne vsak omogočen model, ki je na voljo overjenemu ključu API. Cene so decimalni nizi v USD za en milijon žetonov.

Preverjanje pristnosti

Authorization: Bearer mg_live_...

x-api-key: mg_live_... je tudi sprejet.

Ključi s statusom active oz frozen lahko preberete katalog modelov in njihove ključne cene. Zamrznjeni ključ ostane blokiran za končne točke sklepanja in druge končne točke metapodatkov računa, ki zahtevajo aktivni ključ.

Zahteva

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

Odziv

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

Cenovna polja

• cost je dejanski tečaj Model Gate, ki se uporablja za obremenitev stanja na računu.
• official_cost je shranjen uradni kataloški tečaj ponudnika.
• usage_cost je efektivna stopnja, ki se uporablja samo za ponastavljiv ključ API in omejitve uporabe skupine.
• usage_pricing identificira osnovo, množitelj in vir dedovanja za overjen ključ.
• Ko ima predloga za obračunavanje računa paketni koeficient, ki se razlikuje od 1, batch_cost prikazuje efektivne dejanske stopnje za Claude/OpenAI-združljive paketne elemente in batch_pricing.multiplier identificira dodatni koeficient vrat modela. Ta pogojna polja so izpuščena, ko je koeficient 1. Native async=true ne uporablja tega koeficienta.

Za official_price, vsak prikazan usage_cost stopnja je official_cost × multiplier. Za user_price, je cost × multiplier. To so kataloške cene na milijon žetonov. Končna poravnava zahteve najprej izračuna in zaokroži izbrani osnovni znesek zahteve na 10 decimalnih mest, nato uporabi množitelj in rezultat zaokroži na 10 decimalnih mest.

Mejna polja modela

• context_window je vrednost kontekstnega okna, ki gleda odjemalca, in je trenutno enaka context_length.
• max_input_tokens je konfigurirana največja vrednost vhodnega žetona, če je znana.
• max_output_tokens je konfigurirana največja vrednost izhodnega žetona, če je znana.
• max_completion_tokens je združljivo polje omejitve dokončanja, ki ga uporabljajo metapodatki modela v slogu ponudnika.
• Številčna vrednost 0 pomeni, da Model Gate nima konfigurirane vrednosti za to mejo. Odjemalci z izbirnimi ročnimi preglasitvami omejitev bi morali to nastavitev pustiti nenastavljeno, namesto da bi jo obravnavali 0 kot dejansko mejo modela ali ugibanje druge vrednosti.

Potrjeno /models se prikaže tudi stran Kontekst, Največji vnos, in Največja moč za znane vrednosti, ki niso nič, tako da navadnim uporabnikom ni treba poizvedovati po API-ju samo za kopiranje teh omejitev v konfiguracijo odjemalca.

Napake

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