Códigos de status

Os endpoints retornam códigos de status HTTP apropriados com base no sucesso ou falha da solicitação na linha de status HTTP (ex.: HTTP/1.1 200 OK ou HTTP/1.1 400 Bad Request). Os códigos de status comuns são:

• 200: Sucesso
• 400: Solicitação inválida (parâmetros ausentes, JSON inválido, etc.)
• 404: Não encontrado (o modelo não existe, etc.)
• 429: Muitas solicitações (ex.: quando um limite de taxa é excedido)
• 500: Erro interno do servidor
• 502: Gateway inválido (ex.: quando um modelo de nuvem não pode ser acessado)

Mensagens de erro

Os erros são retornados no formato application/json com a seguinte estrutura, com a mensagem de erro na propriedade error:

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

Erros que ocorrem durante o streaming

Se um erro ocorrer no meio do streaming, o erro será retornado como um objeto no formato application/x-ndjson com uma propriedade error. Como a resposta já foi iniciada, o código de status da resposta não será alterado.

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