Коди стану

Ендпоінти повертають відповідні коди стану HTTP залежно від успішності або невдачі запиту в рядку стану HTTP (наприклад, HTTP/1.1 200 OK або HTTP/1.1 400 Bad Request). Поширені коди стану:

• 200: Успіх
• 400: Неправильний запит (відсутні параметри, некоректний JSON тощо)
• 404: Не знайдено (модель не існує тощо)
• 429: Занадто багато запитів (наприклад, при перевищенні ліміту запитів)
• 500: Внутрішня помилка сервера
• 502: Неправильний шлюз (наприклад, коли хмарну модель не вдається досягти)

Повідомлення про помилки

Помилки повертаються у форматі application/json з наступною структурою, де повідомлення про помилку міститься у властивості error:

{
  "error": "the model failed to generate a response"
}

Помилки, що виникають під час потокової передачі

Якщо помилка виникає посеред потокової передачі, вона повертається як об'єкт у форматі application/x-ndjson з властивістю error. Оскільки відповідь вже розпочата, код стану відповіді не буде змінено.

{"model":"gemma4","created_at":"2025-10-26T17:21:21.196249Z","response":" Yes","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.207235Z","response":".","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.219166Z","response":"I","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:21:21.231094Z","response":"can","done":false}
{"error":"an error was encountered while running the model"}