Codici di stato

Gli endpoint restituiscono codici di stato HTTP appropriati in base al successo o al fallimento della richiesta nella riga di stato HTTP (es. HTTP/1.1 200 OK o HTTP/1.1 400 Bad Request). I codici di stato comuni sono:

• 200: Successo
• 400: Richiesta non valida (parametri mancanti, JSON non valido, ecc.)
• 404: Non trovato (il modello non esiste, ecc.)
• 429: Troppe richieste (es. quando viene superato un limite di frequenza)
• 500: Errore interno del server
• 502: Gateway non valido (es. quando non è possibile raggiungere un modello cloud)

Messaggi di errore

Gli errori vengono restituiti nel formato application/json con la seguente struttura, con il messaggio di errore nella proprietà error:

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

Errori che si verificano durante lo streaming

Se si verifica un errore a metà dello streaming, l'errore verrà restituito come oggetto nel formato application/x-ndjson con una proprietà error. Poiché la risposta è già iniziata, il codice di stato della risposta non verrà modificato.

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