POST /v1/chat/completions

Zahteva

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 je lahko kanonični ID ali omogočen vzdevek. Model Gate razreši vzdevke pred določanjem cen in pošlje kanonični ID navzgor.

Odziv

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

Zahteva za pretakanje

Set "stream": true. Dogodki, poslani s strežnika navzgor, so posredovani brez ponovnega zapisovanja koristnih obremenitev uspešnih dogodkov.

Asinhrona zahteva

Za podprte končne točke dodajte "async": true z "stream": false. Takojšen odgovor je HTTP 202 in vsebuje request_id in Partner API rezultat URL.

Napake

Status ponudnika, ki ni 2xx, telo in vrsta vsebine se prenesejo nespremenjeni. Lokalno ustvarjene napake preverjanja veljavnosti uporabljajo ovojnico napak Model Gate.

Stanje	Pomen	Akcija
400	Neveljavna zahteva	Preverite telo zahteve in ID modela.
401	Neveljaven ali zamrznjen ključ	Preverite ali obrnite ključ API.
429	Omejitev stopnje ali sočasnosti je presežena	Spoštovanje Retry-After in poskusite znova z odmikom.
5xx	Začasna napaka navzgor ali prehoda	Znova poskusite idempotentne zahteve z eksponentnim odmikom.