Hatalar

Reigniter API standart HTTP durum kodları kullanır. Her hata yanıtı JSON.

Hata gövdesi

Çoğu hata şöyle görünür:

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMITED",
  "retryAfter": 37
}

Saha	Her zaman mevcut	Nedir
`error`	Evet	Bir kişiye gösterebileceğiniz bir mesaj. Kelime değişikliği olabilir, bu yüzden eşleştirmeyin.
`code`	En çok hata	Kararlı, büyük harflerle yazılmış bir kod. Bunun üzerine dallan.
`details`	Bazı hatalar	Ekstra bağlam, örneğin `retryAfter` veya kullanım rakamları.
`retryAfter`	Bazı `429`	Tekrar denemeden önce saniyeler beklemeli.

Bazı hataların code yoktur, örneğin 404 Job not found ve 403 Forbidden. Bunların durumunu dallayın.

Doğrulama hataları

İstek gövdesi şema ile eşleşmediğinde, her problemi field: message olarak listeleyen bir detail dizesi 400 alınır:

{
  "error": "Validation failed",
  "detail": "aspect: Invalid option: expected one of \"9:16\"|\"16:9\"|\"1:1\"|\"4:5\"|\"4:3\"|\"3:4\""
}

Durum kodları

Durum	Anlamı	Ne yapmalı?
`200`	Başarı.
`201`	Oluşturuldu (webhooks).
`202`	Kabul edildi. Render başladı.	İşi anketle yap ya da webhook’u bekle.
`400`	İstek reddedildi. Hiçbir şey suçlanmadı.	İsteği düzeltin. Değiştirmeden tekrar denemeyin.
`401`	Eksik, geçersiz veya iptal edilmiş API anahtarı.	Anahtarı kontrol et.
`402`	Plan, kredi veya kullanım sorunu.	`code` okuyun.
`403`	Askıya alınmış hesap ya da size ait olmayan bir iş.	Destek ile iletişime geçin ya da iş kimliğini kontrol edin.
`404`	Bulunamadı.	Kimliği veya yolu kontrol et.
`409`	Tekrarlanan talep veya limit ulaşıldı.	`code` okuyun.
`413`	Bu render, render başına sınırdan daha pahalıya mal olurdu.	Daha az sahne veya daha düşük `quality` kullanın.
`422`	Render üzerinde bir marka, ürün ya da sunucu yoktur.	Making videolarına bakınız.
`429`	Çok fazla istek veya aynı anda çok fazla render.	Bekle ve tekrar dene. Sınırlara bak.
`500`	Bizim tarafımızda bir şeyler ters gitti.	Sonra tekrar dene.
`502`	Sizin kısa sürenizden yapılan planlama başarısız oldu. Planlama kredileri iade edildi.	Tekrar dene, ya da brifingi yeniden ifade et.
`503`	Rendering duraklatıldı veya bir hizmet kapandı. Hiçbir ücret alınmadı.	Sonra tekrar dene.

/v1/ altında bilinmeyen bir yol 404 ile code: "NOT_FOUND" ile döner.

Hata kodları

Doğrulama ve plan

Kod	Durum	Anlamı
`NO_API_KEY`	401	`Authorization` başlık yok veya token `emp_` ile başlamaz.
`INVALID_API_KEY`	401	Anahtar bilinmiyor veya iptal ediliyor.
`PLAN_UPGRADE_REQUIRED`	402	API erişim Agency planı gerektirir.
`ACCOUNT_SUSPENDED`	403	Hesap askıya alındı.

Krediler ve kullanım

Kod	Durum	Anlamı
`NO_CREDITS`	402	Hesabın kredisi kalmadı.
`INSUFFICIENT_CREDITS`	402	Bu render için yeterli kredi yok.
`ABUSE_CAP_EXCEEDED`	402	Planın aylık kullanım sınırına ulaşılır.
`STORAGE_FULL`	402	Hesabın video kütüphanesi dolu. Bazı videoları kaldırın.
`UPGRADE_REQUIRED`	402	Video ücretli bir plana ihtiyaç duyuyor.
`REQUEST_COST_TOO_HIGH`	413	Bu tek render, render başına sınırdan daha pahalıya mal olurdu.

Krediler ve planlar için Hesap ve faturalama bölümüne bakınız.

Render talepleri

Kod	Durum	Anlamı
`CONTENT_BLOCKED`	400	Kısa veya sahne içerik kurallarını çiğnemez.
`PRODUCT_IMAGE_REQUIRED`	400	Bu format `product_image_url` veya `product_enabled: false` gerektirir.
`PRESENTER_REQUIRED`	400	Bir konuşma sahnesinin yüzü yoktur. `avatar_preset_id` ekleyin ya da `presenter_enabled: false` gönderin.
`UNSUPPORTED_MODEL`	400	Bir sahne, kullanamadığı Reigniter bir render modeli istedi.
`BRAND_REQUIRED`	422	Bir marka istendi ama bulunamadı. Gönder `brand_logo_url`.
`NO_ANCHOR`	422	Marka, ürün fotoğrafı veya sunucu yok. Birini ekle ya da çıkar.
`CANVAS_NOT_FOUND`	404	Bu hesapta referans verilen bir proje yok.
`DUPLICATE_REQUEST`	409	Bu `Idempotency-Key` zaten kullanılmıştı. Yeni bir şey şarj edilmedi.
`PLAN_FAILED`	502	Brief’ten yapılan planlama başarısız oldu. Planlama kredileri iade edildi.

Bir brief ile birlikte, tekrarlanan bir Idempotency-Key da 402 olarak da This request was already submitted mesajıyla geri dönebilir. Bunu bir kredi sorunu olarak değil, bir kopya olarak ele alın.

Oran ve eşzamanlılık

Kod	Durum	Anlamı
`RATE_LIMITED`	429	Çok fazla istek var. `retryAfter` (ya da `details.retryAfter`) saniye bekle.
`CONCURRENT_LIMIT`	429	Aynı anda çok fazla render çalışıyor. Birinin bitmesini bekle.

Hizmet

Kod	Durum	Anlamı
`USAGE_CHECK_UNAVAILABLE`	503	Kullanım kontrol edilemedi, bu yüzden render durakladı. Hiçbir şey ücretlendirilmedi.
`DB_UNAVAILABLE`	503	Bir hizmet kısa süreliğine kullanılamaz.
`FEATURE_NOT_AVAILABLE`	503	Rendering şu anda mevcut değil.
`GLOBAL_KILL_SWITCH`	503	Render herkes için duraklatıldı.
`FEATURE_KILL_SWITCH`	503	Bu özellik duraklatıldı.
`USER_KILL_SWITCH`	503	Bu hesap geçici olarak kısıtlıdır. Destek ile iletişime geçin.

Webhooks

Kod	Durum	Anlamı
`UNKNOWN_EVENT`	400	Abone olabileceğiniz bir etkinlik değil. Yanıtta geçerli olanlar listeleniyor.
`URL_NOT_DELIVERABLE`	400	URL, halka açık bir http(ler) adresi değildir.
`HOOK_LIMIT`	409	Hesapta zaten maksimum web hook sayısı var.

Güvenli bir şekilde tekrar denemeye çalışıyor

Geri dönüşle 429, 500, 502 ve 503 tekrar dene. Diğer 4xx değişmeden tekrar denemeyin.
Her zaman Idempotency-Key gönderin POST /v1/render.
Hiç yanıt yok (zaman aşımı veya bağlantı kesilmesi): aynı anahtarla tekrar deneme. Eğer ilk istek render başlattıysa, ikinci deneme başlatılmaz.
Bir hata yanıtı: o istek için render başlatılmadı. Nedeni düzeltin, sonra yeni bir anahtarla tekrar deneyin, çünkü yarı yolda başarısız olan bir istek anahtarını zaten kullanmış olabilir. Render kredileri geri ödenir. Geri ödenmeyen tek ücret, planlanan render reddedildiğinde kısa bir planlamadır ( bkz. Video yapma).
Bir render kabul edildiyse (202 sonra başarısız olursa, işin status failed olur ve error nedenini söyler. Gerçekleşmeyen iş için verilen krediler iade edilir.