GET /v1/models

Retourneert elk ingeschakeld model dat beschikbaar is voor de geverifieerde API-sleutel. Prijzen zijn decimale tekenreeksen in USD per miljoen tokens.

Authenticatie

Authorization: Bearer mg_live_...

x-api-key: mg_live_... wordt ook geaccepteerd.

Sleutels met status active of frozen kan de modelcatalogus en hun sleutelspecifieke prijzen lezen. Een bevroren sleutel blijft geblokkeerd voor gevolgtrekkingseindpunten en voor andere eindpunten met metagegevens van accounts waarvoor een actieve sleutel vereist is.

Verzoek

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

Antwoord

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

Prijsvelden

• cost is het werkelijke Model Gate-tarief dat wordt gebruikt om het rekeningsaldo af te schrijven.
• official_cost is het opgeslagen officiële catalogustarief van de aanbieder.
• usage_cost is het effectieve tarief dat alleen wordt gebruikt voor opnieuw in te stellen API-sleutel- en groepsgebruikslimieten.
• usage_pricing identificeert de basis, vermenigvuldiger en overervingsbron voor de geverifieerde sleutel.
• Wanneer de accountfactureringssjabloon een batchcoëfficiënt heeft die afwijkt van 1, batch_cost toont de effectieve werkelijke tarieven voor Claude/OpenAI-compatibele batchartikelen en batch_pricing.multiplier identificeert de aanvullende Model Gate-coëfficiënt. Deze voorwaardelijke velden worden weggelaten als de coëfficiënt gelijk is 1. Oorspronkelijk async=true maakt geen gebruik van deze coëfficiënt.

Voor official_price, elk weergegeven usage_cost tarief is official_cost × multiplier. Voor user_price, het is cost × multiplier. Dit zijn catalogustarieven per miljoen tokens. De definitieve aanvraagafhandeling berekent eerst het geselecteerde basisaanvraagbedrag en rondt dit af op 10 decimalen, past vervolgens de vermenigvuldiger toe en rondt het resultaat af op 10 decimalen.

Modellimietvelden

• context_window is de klantgerichte contextvensterwaarde en is momenteel gelijk aan context_length.
• max_input_tokens is de geconfigureerde maximale invoertokenwaarde, indien bekend.
• max_output_tokens is de geconfigureerde maximale uitvoertokenwaarde, indien bekend.
• max_completion_tokens is het compatibiliteitsveld voor de voltooiingslimiet dat wordt gebruikt door metagegevens van het providermodel.
• Een numerieke waarde van 0 betekent dat Model Gate geen geconfigureerde waarde voor die limiet heeft. Clients met optionele handmatige limietoverschrijvingen moeten deze instelling uitgeschakeld laten in plaats van behandelen 0 als een daadwerkelijke modellimiet of het raden van een andere waarde.

De geauthenticeerde /models pagina wordt ook weergegeven Context, Maximale invoer, En Maximale output voor bekende waarden die niet nul zijn, zodat gewone gebruikers de API niet hoeven te bevragen om deze limieten naar een clientconfiguratie te kopiëren.

Fouten

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