POST /v1/chat/completions

Žiadosť

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ch-47",
    "messages": [
      {"role": "user", "content": "Explain this API in one sentence."}
    ],
    "stream": false
  }'

The model môže byť kanonické ID alebo povolený alias. Model Gate rieši aliasy pred stanovením ceny a odošle kanonické ID upstream.

odpoveď

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "model": "claude-opus-4.7",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "Model Gate provides one compatible API for multiple AI models."},
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 14,
    "completion_tokens": 17,
    "total_tokens": 31
  }
}

Žiadosť o streamovanie

Set "stream": true. Upstream Server-Sent Events prechádzajú bez prepisovania úspešných dát udalostí.

Asynchrónna požiadavka

Pre podporované koncové body pridajte "async": true s "stream": false. Okamžitou odpoveďou je HTTP 202 a obsahuje request_id a adresu URL výsledku Partner API.

Chyby

Stav poskytovateľa mimo 2xx, telo a typ obsahu sa prenesú nezmenené. Lokálne generované chyby overenia používajú obálku chýb Model Gate.

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.