POST /v1/messages

Autentifikácia

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

Akceptuje sa aj overenie nosiča.

Žiadosť

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

odpoveď

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

Streamovanie

Pridať "stream": true. Model Gate postupuje udalosti SSE kompatibilné s Anthropic a zaznamenáva konečné použitie tokenu na vyrovnanie.

Aliasy a účtovníctvo

Ak je zadaný alias, nahradí sa kanonickým modelom pred zaradením požiadavky do frontu alebo odoslaním proti prúdu. Ceny, náklady na používanie, história požiadaviek a obmedzenia modelu používajú kanonický model.

Stav	Význam	Akcia
400	Neplatná požiadavka	Skontrolujte telo žiadosti a ID modelu.
401	Neplatný alebo zamrznutý kľúč	Overte alebo otočte kľúč API.
429	Prekročený limit rýchlosti alebo súbežnosti	Rešpekt Retry-After a skúste to znova so stiahnutím.
5xx	Dočasná chyba upstream alebo brány	Skúste znova idempotentné požiadavky s exponenciálnym stiahnutím.