POST /v1/chat/completions

Taotlus

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 võib olla kanooniline ID või lubatud alias. Model Gate lahendab varjunimed enne hinnakujundust ja saadab kanoonilise ID ülesvoolu.

Vastus

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

Voogesituse taotlus

Määra "stream": true. Ülesvoolu serveri poolt saadetud sündmused edastatakse ilma edukate sündmuste kasulikke koormusi ümber kirjutamata.

Asünkroonne päring

Toetatud lõpp-punktide jaoks lisage "async": true koos "stream": false. Vahetu vastus on HTTP 202 ja sisaldab request_id ja Partner API tulemuse URL.

Vead

Pakkuja mitte-2xx olek, sisu ja sisu tüüp edastatakse muutmata kujul. Kohalikult loodud valideerimisvead kasutavad mudelivärava veaümbrikut.

Olek	Tähendus	Tegevus
400	Kehtetu taotlus	Kontrollige päringu sisu ja mudeli ID-d.
401	Kehtetu või külmunud võti	Kinnitage või pöörake API-võtit.
429	Kursuse või samaaegsuse limiit on ületatud	Respekt Retry-After ja proovige tagasilöögiga uuesti.
5xx	Ajutine ülesvoolu või lüüsi viga	Proovige uuesti idempotentseid taotlusi eksponentsiaalse taganemisega.