Rivya API public hata kodlarını, HTTP durum değerlerini, rate limitleri, idempotency çakışmalarını ve retry kararlarını yönetin.

Rivya API, JSON içinde kararlı public hata kodları döndürür. Entegrasyon sözleşmesi olarak error.code değerini kullanın.

Hata Yapısı

{
  "error": {
    "code": "api_key_missing",
    "message": "A valid Bearer API key is required.",
    "requestId": "req_..."
  }
}

Başarısız bir API isteğini araştırması için Rivya destek ekibine başvururken günlüklerinizde requestId değerini saklayın.

Kararlı Hata Kodları

Code	HTTP status	Anlamı	Önerilen işlem
`public_api_disabled`	503	Public API çağrıları geçici olarak devre dışı.	Daha sonra yeniden deneyin veya Studio'yu elle kullanın.
`api_key_missing`	401	İstek bir Bearer API anahtarı içermiyor.	`Authorization: Bearer rvya_sk_...` gönderin.
`api_key_invalid`	401	Anahtar doğrulanamıyor.	Anahtarı kontrol edin ve gerekirse rotate edin.
`api_key_revoked`	401	Anahtar Settings içinde iptal edilmiş.	Yeni bir anahtar oluşturun.
`api_key_expired`	401	Anahtar artık geçerli değil.	Yeni bir anahtar oluşturun.
`api_scope_denied`	403	Anahtarda gerekli scope yok.	Gerekli scope'a sahip bir anahtar oluşturun.
`rate_limited`	429	Geçerli pencerede çok fazla istek var.	Backoff uygulayın ve daha sonra yeniden deneyin.
`validation_failed`	400	Gövde, model, prompt veya parametreler geçersiz.	Gövdenizi model referansıyla karşılaştırın.
`not_found`	404	İstenen görev yok veya hesaba ait değil.	Public görev ID'sini ve hesap sınırını kontrol edin.
`webhook_url_rejected`	400	Webhook endpoint URL'sine izin verilmiyor.	Credentials, fragment, localhost veya özel ağ adresleri içermeyen public HTTPS URL kullanın.
`chat_model_not_supported`	400	Seçilen model Chat API için kullanılamıyor.	`/api/v1/models` okuyun ve kullanılabilir bir chat modeli seçin.
`chat_session_conflict`	409	Chat oturumu bu istek için kullanılamaz.	Aynı hesap ve modele ait, API tarafından oluşturulmuş bir oturum kullanın.
`chat_attachment_not_supported`	400	Chat eki desteklenmiyor.	Files API üzerinden bir görüntü yükleyin ve `file_id` değerini gönderin.
`idempotency_conflict`	409	Aynı idempotency anahtarı farklı input ile yeniden kullanıldı.	Yeni bir anahtar kullanın veya tamamen aynı gövdeyi yeniden gönderin.
`insufficient_credits`	402	Hesapta yeterli kredi yok.	Kredi ekleyin veya daha düşük maliyetli bir istek seçin.
`internal_error`	500	İstek tamamlanamadı.	Idempotency ile yeniden deneyin veya `requestId` ile destek ekibine başvurun.

Rate Limitler

Rivya, API anahtarı başına uygulama düzeyinde Public API rate limitleri uygular. Varsayılan production limiti PUBLIC_API_RATE_LIMIT_PER_MINUTE ile yapılandırılır.

rate_limited aldığınızda exponential backoff kullanın. Sıkı bir döngü içinde yeniden denemeyin.

İdempotent Yeniden Denemeler

Her production POST /api/v1/generations ve POST /api/v1/chat/completions isteğiyle Idempotency-Key gönderin.

Önerilen kalıp:

her mantıksal oluşturma isteği için benzersiz bir anahtar üretin
aynı anahtarı yalnızca aynı gövdeyi yeniden denerken kullanın
dönen public görev ID'sini kendi iş kaydınızla birlikte saklayın
Chat API için aynı konuşmaya devam etmek istediğinizde dönen session_id değerini saklayın
tek bir anahtarı farklı model, prompt veya parametreler için yeniden kullanmayın

Gönderimden sonra ağ hatası oluşursa aynı gövde ve aynı Idempotency-Key ile yeniden deneyin. Rivya, duplicate görev oluşturmak yerine saklanan public yanıtı döndürebilir.

Retry Kararları

Şunları backoff ile yeniden deneyin:

public_api_disabled
rate_limited
internal_error
geçici ağ hataları

Input değiştirmeden şunları yeniden denemeyin:

api_key_invalid
api_key_revoked
api_scope_denied
validation_failed
webhook_url_rejected
chat_model_not_supported
chat_session_conflict
chat_attachment_not_supported
idempotency_conflict
insufficient_credits

API Hataları ve Limitleri

Hata Yapısı

Kararlı Hata Kodları

Rate Limitler

İdempotent Yeniden Denemeler

Retry Kararları

İlgili Sayfalar

İçindekiler