POST /v1/chat/completions

Заявка

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 can be a canonical ID or an enabled alias. Model Gate разрешава псевдоними преди ценообразуване и изпраща каноничния идентификатор нагоре по веригата.

Отговор

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

Заявка за поточно предаване

Комплект "stream": true. Събитията, изпратени от сървъра нагоре по веригата, се предават без пренаписване на успешни полезни натоварвания на събития.

Асинхронна заявка

За поддържани крайни точки добавете "async": true с "stream": false. Незабавният отговор е HTTP 202 и съдържа request_id и Partner API резултат URL.

Грешки

Статусът на доставчика, който не е 2xx, тялото и типът на съдържанието се предават непроменени. Локално генерираните грешки при валидиране използват обвивката на грешката на Model Gate.

Статус	Значение	Действие
400	Невалидна заявка	Проверете тялото на заявката и ID на модела.
401	Невалиден или замразен ключ	Проверете или завъртете API ключа.
429	Лимитът за скорост или паралелност е надвишен	уважение Retry-After и опитайте отново с backoff.
5xx	Временна грешка нагоре или на шлюза	Опитайте отново идемпотентни заявки с експоненциално забавяне.