POST /v1/messages

Autentificare

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

Este acceptată și autentificarea purtătorului.

Cerere

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

Răspuns

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

Adăuga "stream": true. Model Gate transmite evenimente SSE compatibile cu Antropic și înregistrează utilizarea finală a simbolului pentru decontare.

Aliasuri și contabilitate

Dacă este furnizat un alias, acesta este înlocuit cu modelul canonic înainte ca cererea să fie pusă în coadă sau trimisă în amonte. Prețurile, costurile de utilizare, istoricul cererilor și restricțiile de model folosesc modelul canonic.

Stare	Sens	Acţiune
400	Solicitare nevalidă	Verificați corpul cererii și ID-ul modelului.
401	Cheie nevalidă sau înghețată	Verificați sau rotiți cheia API.
429	Limita ratei sau concurenței a fost depășită	Respect Retry-After și reîncercați cu backoff.
5xx	Eroare temporară în amonte sau gateway	Reîncercați solicitările idempotente cu backoff exponențial.