Durum kodları

Uç noktalar, HTTP durum satırındaki isteğin başarılı veya başarısız olmasına göre uygun HTTP durum kodlarını döndürür (ör. HTTP/1.1 200 OK veya HTTP/1.1 400 Bad Request). Yaygın durum kodları şunlardır:

• 200: Başarılı
• 400: Hatalı İstek (eksik parametreler, geçersiz JSON vb.)
• 404: Bulunamadı (model mevcut değil vb.)
• 429: Çok Fazla İstek (ör. bir hız sınırı aşıldığında)
• 500: Dahili Sunucu Hatası
• 502: Hatalı Ağ Geçidi (ör. bir bulut modeline ulaşılamadığında)

Hata mesajları

Hatalar, aşağıdaki yapıya sahip application/json formatında döndürülür, hata mesajı error özelliğinde yer alır:

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

Akış sırasında oluşan hatalar

Eğer akış sırasında bir hata oluşursa, hata application/x-ndjson formatında bir error özelliğine sahip nesne olarak döndürülür. Yanıt zaten başlamış olduğu için, yanıtın durum kodu değiştirilmeyecektir.

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