GET /v1/models

Returnerer alle aktiverte modeller som er tilgjengelige for den autentiserte API-nøkkelen. Prisene er desimalstrenger i USD per en million tokens.

Autentisering

Authorization: Bearer mg_live_...

x-api-key: mg_live_... er også akseptert.

Taster med status active eller frozen kan lese modellkatalogen og deres nøkkelspesifikke priser. En fryst nøkkel forblir blokkert fra slutningsendepunkter og fra andre kontometadataendepunkter som krever en aktiv nøkkel.

Forespørsel

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

Svar

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

Prisfelt

• cost er den faktiske Model Gate-satsen som brukes til å belaste kontosaldoen.
• official_cost er den lagrede offisielle leverandørkatalogprisen.
• usage_cost er den effektive satsen som kun brukes for tilbakestillbare API-nøkkel- og gruppebruksgrenser.
• usage_pricing identifiserer grunnlaget, multiplikatoren og arvskilden for den autentiserte nøkkelen.
• Når kontofaktureringsmalen har en batch-koeffisient som er forskjellig fra 1, batch_cost viser de effektive faktiske prisene for Claude/OpenAI-kompatible batchvarer og batch_pricing.multiplier identifiserer den ekstra Model Gate-koeffisienten. Disse betingede feltene er utelatt når koeffisienten er 1. Innfødt async=true bruker ikke denne koeffisienten.

Til official_price, hver vises usage_cost rate er official_cost × multiplier. Til user_price, det er cost × multiplier. Dette er katalogpriser per million token. Endelig forespørselsoppgjør beregner og runder først det valgte basisbeløpet til 10 desimaler, bruker deretter multiplikatoren og runder resultatet av til 10 desimaler.

Modellgrensefelt

• context_window er den klientvendte kontekstvinduverdien og er for øyeblikket lik context_length.
• max_input_tokens er den konfigurerte maksimale input-token-verdien når den er kjent.
• max_output_tokens er den konfigurerte maksimale utdata-token-verdien når den er kjent.
• max_completion_tokens er kompatibilitetsfeltet for fullføringsgrense som brukes av modellmetadata i leverandørstil.
• En numerisk verdi på 0 betyr at Model Gate ikke har en konfigurert verdi for den grensen. Klienter med valgfri manuell grenseoverstyring bør la denne innstillingen være uaktivert i stedet for å behandle 0 som en faktisk modellgrense eller gjette en annen verdi.

Den autentiserte /models siden vises også Kontekst, Maks inngang, og Maks utgang for kjente verdier som ikke er null, så vanlige brukere trenger ikke å spørre API-en bare for å kopiere disse grensene inn i en klientkonfigurasjon.

Feil

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