POST /v1/chat/completions
Završeci chata kompatibilni s OpenAI-om sa strujanjem, alatima, vizijom i aliasima modela.
POST /v1/chat/completions
Zahtjev
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 može biti kanonski ID ili omogućeni alias. Model Gate rješava pseudonime prije određivanja cijene i šalje kanonski ID uzvodno.
Odgovor
{
"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
}
}
Zahtjev za strujanje
set "stream": true. Uzlazni događaji poslani s poslužitelja prolaze bez ponovnog pisanja korisnih podataka o uspješnim događajima.
Asinkroni zahtjev
Za podržane krajnje točke dodajte "async": true s "stream": false. Trenutačni odgovor je HTTP 202 i sadrži request_id i URL rezultata Partner API.
Greške
Status pružatelja koji nije 2xx, tijelo i vrsta sadržaja prolaze nepromijenjeni. Lokalno generirane pogreške provjere valjanosti koriste omotnicu pogreške Model Gate.
| Status | Značenje | Akcijski |
|---|---|---|
400 | Neispravan zahtjev | Provjerite tijelo zahtjeva i ID modela. |
401 | Nevažeći ili zamrznuti ključ | Provjerite ili rotirajte API ključ. |
429 | Premašeno je ograničenje stope ili istovremenosti | Poštovanje Retry-After i pokušajte ponovno s odmakom. |
5xx | Privremena pogreška uzvodnog ili mrežnog pristupnika | Ponovi idempotentne zahtjeve s eksponencijalnim odmakom. |