Коды состояния

Эндпоинты возвращают соответствующие коды состояния 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"}