POST /v1/chat/completions

Kér

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
  }'

A model lehet kanonikus azonosító vagy engedélyezett álnév. A Model Gate feloldja az álneveket az árképzés előtt, és elküldi a kanonikus azonosítót felfelé.

Válasz

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

Streaming kérés

Készlet "stream": true. A felfelé irányuló kiszolgáló által küldött eseményeken a sikeres események átírása nélkül kerül sor.

Aszinkron kérés

A támogatott végpontokhoz adja hozzá "async": true -vel "stream": false. Az azonnali válasz a HTTP 202 és tartalmazza request_id és egy Partner API találati URL-t.

Hibák

A szolgáltató nem 2xx állapota, törzse és tartalomtípusa változatlan formában kerül átadásra. A helyileg generált érvényesítési hibák a Model Gate hibaborítékot használják.

Állapot	Jelentése	Akció
400	Érvénytelen kérés	Ellenőrizze a kérés törzsét és a modellazonosítót.
401	Érvénytelen vagy befagyott kulcs	Ellenőrizze vagy forgassa el az API-kulcsot.
429	Túllépte az árfolyam- vagy egyidejűségi korlátot	Tisztelet Retry-After és próbálja újra a visszalépéssel.
5xx	Ideiglenes upstream vagy átjáróhiba	Próbálja újra az idempotens kéréseket exponenciális visszalépéssel.