GET /v1/models

Vraća svaki omogućeni model dostupan provjerenom API ključu. Cijene su decimalni nizovi u USD za jedan milijun tokena.

Autentifikacija

Authorization: Bearer mg_live_...

x-api-key: mg_live_... također se prihvaća.

Ključevi sa statusom active ili frozen možete pročitati katalog modela i njihove specifične cijene. Zamrznuti ključ ostaje blokiran od krajnjih točaka zaključivanja i od drugih krajnjih točaka metapodataka računa koji zahtijevaju aktivni ključ.

Zahtjev

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

Odgovor

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

Polja cijena

• cost je stvarna stopa Model Gate koja se koristi za terećenje stanja računa.
• official_cost je spremljena službena kataloška cijena dobavljača.
• usage_cost je efektivna stopa koja se koristi samo za API-ključ koji se može resetirati i ograničenja upotrebe grupe.
• usage_pricing identificira osnovu, množitelj i izvor nasljeđivanja za autentificirani ključ.
• Kada predložak za naplatu računa ima skupni koeficijent različit od 1, batch_cost prikazuje efektivne stvarne stope za Claude/OpenAI-kompatibilne skupne stavke i batch_pricing.multiplier identificira dodatni Model Gate koeficijent. Ova uvjetna polja su izostavljena kada je koeficijent 1. Zavičajni async=true ne koristi ovaj koeficijent.

Za official_price, svaki prikazan usage_cost stopa je official_cost × multiplier. Za user_price, jest cost × multiplier. Ovo su kataloške cijene za milijun tokena. Konačna nagodba zahtjeva prvo izračunava i zaokružuje odabrani osnovni iznos zahtjeva na 10 decimalnih mjesta, zatim primjenjuje množitelj i zaokružuje rezultat na 10 decimalnih mjesta.

Polja ograničenja modela

• context_window je vrijednost kontekstnog prozora usmjerenog prema klijentu i trenutno je jednaka context_length.
• max_input_tokens je konfigurirana maksimalna vrijednost ulaznog tokena kada je poznata.
• max_output_tokens je konfigurirana maksimalna vrijednost izlaznog tokena kada je poznata.
• max_completion_tokens je polje kompatibilnosti ograničenja završetka koje koriste metapodaci modela u stilu pružatelja usluga.
• Brojčana vrijednost od 0 znači da Model Gate nema konfiguriranu vrijednost za to ograničenje. Klijenti s opcijskim ručnim nadjačavanjem ograničenja trebali bi ostaviti tu postavku nepostavljenu umjesto liječenja 0 kao stvarno ograničenje modela ili pogađanje druge vrijednosti.

Ovjereni /models stranica također prikazuje Kontekst, Maksimalni unos, i Maks. učinak za poznate vrijednosti različite od nule, tako da obični korisnici ne moraju postavljati upite API-ju samo da bi kopirali ta ograničenja u konfiguraciju klijenta.

Greške

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