GET /v1/models

Returnerer alle aktiverede modeller, der er tilgængelige for den godkendte API-nøgle. Priserne er decimalstrenge i USD pr. en million tokens.

Autentificering

Authorization: Bearer mg_live_...

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

Nøgler med status active eller frozen kan læse modelkataloget og deres nøglespecifikke priser. En fastfrosset nøgle forbliver blokeret fra inferensendepunkter og fra andre kontometadataendepunkter, der kræver en aktiv nøgle.

Anmodning

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

Pris felter

• cost er den faktiske Model Gate-sats, der bruges til at debitere kontosaldoen.
• official_cost er den gemte officielle udbyderkatalogpris.
• usage_cost er den effektive sats, der kun bruges til nulstillelige API-nøgler og gruppebrugsgrænser.
• usage_pricing identificerer grundlaget, multiplikatoren og arvskilden for den godkendte nøgle.
• Når kontofaktureringsskabelonen har en batchkoefficient forskellig fra 1, batch_cost viser de effektive faktiske priser for Claude/OpenAI-kompatible batchvarer og batch_pricing.multiplier identificerer den ekstra Model Gate-koefficient. Disse betingede felter udelades, når koefficienten er 1. Hjemmehørende async=true bruger ikke denne koefficient.

For official_price, hver vist usage_cost sats er official_cost × multiplier. For user_price, det er cost × multiplier. Disse er katalogpriser pr. million tokens. Den endelige anmodningsafregning beregner og afrunder først det valgte basisanmodningsbeløb til 10 decimaler, anvender derefter multiplikatoren og afrunder resultatet til 10 decimaler.

Modelgrænsefelter

• context_window er den klientvendte kontekstvindueværdi og er i øjeblikket lig med context_length.
• max_input_tokens er den konfigurerede maksimale input-token-værdi, når den er kendt.
• max_output_tokens er den konfigurerede maksimale output-token-værdi, når den er kendt.
• max_completion_tokens er kompatibilitetsfeltet med fuldførelsesgrænse, der bruges af modelmetadata i udbyderstil.
• En numerisk værdi på 0 betyder, at Model Gate ikke har en konfigureret værdi for denne grænse. Klienter med valgfri manuel grænsetilsidesættelse bør lade denne indstilling være deaktiveret i stedet for at behandle 0 som en faktisk modelgrænse eller gætte en anden værdi.

Den autentificerede /models siden vises også Sammenhæng, Max input, og Max output for kendte værdier, der ikke er nul, så almindelige brugere behøver ikke at forespørge API'et bare for at kopiere disse grænser ind i en klientkonfiguration.

Fejl

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