POST /v1/messages

Autentisering

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

Bärarautentisering accepteras också.

Begäran

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."}
    ]
  }'

Svar

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

Streaming

Tillägga "stream": true. Model Gate vidarebefordrar Anthropic-kompatibla SSE-händelser och registrerar den slutliga tokenanvändningen för avveckling.

Alias ​​och redovisning

Om ett alias tillhandahålls, ersätts det med den kanoniska modellen innan begäran köas eller skickas uppströms. Prissättning, användningskostnad, förfrågningshistorik och modellbegränsningar använder den kanoniska modellen.

Status	Menande	Handling
400	Ogiltig begäran	Kontrollera förfrågans innehåll och modell-ID.
401	Ogiltig eller fryst nyckel	Verifiera eller rotera API-nyckeln.
429	Belopps- eller samtidighetsgränsen har överskridits	Respektera Retry-After och försök igen med backoff.
5xx	Tillfälligt uppströms- eller gateway-fel	Försök med idempotenta förfrågningar igen med exponentiell backoff.