Statuscodes

Eindpunten retourneren de juiste HTTP-statuscodes op basis van het al dan niet slagen van de aanvraag in de HTTP-statusregel (bijv. HTTP/1.1 200 OK of HTTP/1.1 400 Bad Request). Veelvoorkomende statuscodes zijn:

• 200: Succes
• 400: Slechte aanvraag (ontbrekende parameters, ongeldige JSON, etc.)
• 404: Niet gevonden (het model bestaat niet, etc.)
• 429: Te veel aanvragen (bijv. wanneer een snelheidslimiet is overschreden)
• 500: Interne serverfout
• 502: Slechte gateway (bijv. wanneer een cloudmodel niet bereikbaar is)

Foutmeldingen

Fouten worden geretourneerd in het application/json-formaat met de volgende structuur, waarbij de foutmelding zich in de error-eigenschap bevindt:

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

Fouten die optreden tijdens het streamen

Als er midden in de stream een fout optreedt, wordt de fout geretourneerd als een object in het application/x-ndjson-formaat met een error-eigenschap. Omdat de respons al is gestart, wordt de statuscode van de respons niet gewijzigd.

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