Códigos de estado

Los endpoints devuelven códigos de estado HTTP adecuados en función del éxito o fracaso de la solicitud en la línea de estado HTTP (por ejemplo, HTTP/1.1 200 OK o HTTP/1.1 400 Bad Request). Los códigos de estado más comunes son:

• 200: Éxito
• 400: Solicitud incorrecta (parámetros faltantes, JSON inválido, etc.)
• 404: No encontrado (el modelo no existe, etc.)
• 429: Demasiadas solicitudes (por ejemplo, cuando se supera un límite de tasa)
• 500: Error interno del servidor
• 502: Puerta de enlace incorrecta (por ejemplo, cuando no se puede acceder a un modelo en la nube)

Mensajes de error

Los errores se devuelven en el formato application/json con la siguiente estructura, con el mensaje de error en la propiedad error:

{
  "error": "el modelo no pudo generar una respuesta"
}

Errores que se producen durante la transmisión

Si se produce un error a mitad de la transmisión, el error se devolverá como un objeto en el formato application/x-ndjson con una propiedad error. Dado que la respuesta ya ha comenzado, el código de estado de la respuesta no se modificará.

{"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":"se encontró un error al ejecutar el modelo"}