GET /v1/models

Returnerar alla aktiverade modeller som är tillgängliga för den autentiserade API-nyckeln. Priserna är decimalsträngar i USD per en miljon tokens.

Autentisering

Authorization: Bearer mg_live_...

x-api-key: mg_live_... accepteras också.

Nycklar med status active eller frozen kan läsa modellkatalogen och deras nyckelspecifika prissättning. En fryst nyckel förblir blockerad från slutpunkter för slutpunkter och från andra kontometadataslutpunkter som kräver en aktiv nyckel.

Begäran

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

Prisfält

• cost är den faktiska Model Gate-kursen som används för att debitera kontosaldot.
• official_cost är den sparade officiella leverantörskatalogen.
• usage_cost är den effektiva hastigheten som endast används för återställningsbara API-nyckel- och gruppanvändningsgränser.
• usage_pricing identifierar grunden, multiplikatorn och arvskällan för den autentiserade nyckeln.
• När kontots faktureringsmall har en annan batchkoefficient än 1, batch_cost visar de effektiva faktiska priserna för Claude/OpenAI-kompatibla batchartiklar och batch_pricing.multiplier identifierar den extra Model Gate-koefficienten. Dessa villkorade fält utelämnas när koefficienten är 1. Inföding async=true använder inte denna koefficient.

För official_price, var och en visas usage_cost kursen är official_cost × multiplier. För user_price, det är det cost × multiplier. Dessa är katalogpriser per miljon token. Slutlig förfrågningsavräkning beräknar och avrundar först det valda basbeloppet till 10 decimaler, tillämpar sedan multiplikatorn och avrundar resultatet till 10 decimaler.

Modellgränsfält

• context_window är det klientvända kontextfönstrets värde och är för närvarande lika med context_length.
• max_input_tokens är det konfigurerade maximala indata-tokenvärdet när det är känt.
• max_output_tokens är det konfigurerade maximala utdata-tokenvärdet när det är känt.
• max_completion_tokens är kompatibilitetsfältet för slutförandebegränsning som används av metadata för modellmodeller av leverantörstyp.
• Ett numeriskt värde på 0 betyder att Model Gate inte har ett konfigurerat värde för den gränsen. Klienter med valfria manuella gränsöverskridanden bör lämna den inställningen oinställd snarare än att behandla 0 som en faktisk modellgräns eller att gissa ett annat värde.

Den autentiserade /models sidan visas också Sammanhang, Max ingång, och Max effekt för kända värden som inte är noll, så vanliga användare behöver inte fråga API bara för att kopiera dessa gränser till en klientkonfiguration.

Fel

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