POST /v1/messages

Authenticatie

x-api-key: mg_live_...
anthropic-version: 2023-06-01
content-type: application/json

Bearer-authenticatie wordt ook geaccepteerd.

Verzoek

curl https://api.model-gate.com/v1/messages \
  -H "x-api-key: mg_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a short release note."}
    ]
  }'

Antwoord

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4.6",
  "content": [{"type": "text", "text": "This release improves documentation and model routing."}],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 11,
    "output_tokens": 9,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Streamen

Toevoegen "stream": true. Model Gate stuurt Anthropic-compatibele SSE-gebeurtenissen door en registreert het uiteindelijke tokengebruik voor afwikkeling.

Aliassen en boekhouding

Als er een alias wordt opgegeven, wordt deze vervangen door het canonieke model voordat het verzoek in de wachtrij wordt geplaatst of stroomopwaarts wordt verzonden. Prijzen, gebruikskosten, aanvraaggeschiedenis en modelbeperkingen maken gebruik van het canonieke model.

Status	Betekenis	Actie
400	Ongeldig verzoek	Controleer de hoofdtekst van het verzoek en de model-ID.
401	Ongeldige of bevroren sleutel	Controleer of roteer de API-sleutel.
429	Tarief- of gelijktijdigheidslimiet overschreden	Respect Retry-After en probeer het opnieuw met uitstel.
5xx	Tijdelijke upstream- of gatewayfout	Probeer idempotente aanvragen opnieuw met exponentieel uitstel.