POST /v1/messages

Autentizace

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

Přijímá se také autentizace nositele.

Žádost

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

Odpověď

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

Streamování

Přidat "stream": true. Model Gate předává události SSE kompatibilní s Anthropic a zaznamenává konečné použití tokenu pro vypořádání.

Přezdívky a účetnictví

Pokud je zadán alias, je nahrazen kanonickým modelem předtím, než je požadavek zařazen do fronty nebo odeslán proti proudu. Ceny, náklady na použití, historie požadavků a omezení modelu používají kanonický model.

Postavení	Význam	Akce
400	Neplatný požadavek	Zkontrolujte tělo požadavku a ID modelu.
401	Neplatný nebo zamrzlý klíč	Ověřte nebo otočte klíč API.
429	Byl překročen limit rychlosti nebo souběžnosti	Respektovat Retry-After a zkuste to znovu s ustoupením.
5xx	Dočasná chyba upstreamu nebo brány	Opakujte idempotentní požadavky s exponenciálním stažením.