AiVideoEditor
Ücretsiz başlayın
Menü

İnceleme 2026-11-10 · API sürümü 2026-11-09 · Markdown oku

Hatalar, yeniden denemeler ve kurtarma

API hataları; isteğe bağlı alan hataları, hedef hataları, yeniden deneme ipuçları ve eylem devirleriyle birlikte { "error": { "code": "…", "message": "…", "requestId": "…" } } biçimini kullanır. Destek için requestId değerini saklayın. Tanılama toplarken kimlik bilgilerini, imzalı yükleme URL'lerini veya hassas istek içeriğini günlüğe yazmayın.

YanıtKurtarma
401 unauthenticatedEksik, bozuk veya iptal edilmiş ürün anahtarını kontrol edin
403 forbidden_scope / account_not_allowedAnahtar kapsamlarını ve hedef erişimini gözden geçirin
402 account_limit, seat_limit, storage_limitÇalışma alanı yetkilendirmesini ve kaynak kullanımını gözden geçirin
402 subscription_inactive / trial_expiredFaturalama durumunu çözün; taslakları ve kuyruktaki işleri koruyun
409 revision_conflictGeçerli sürümü okuyun, değişiklikleri inceleyin ve kasıtlı olarak yeniden uygulayın
409 idempotency_conflictAnahtar farklı bir gövdeyle yeniden kullanıldı; özgün işlemi mutabık kılın
409 consent_requiredYetkili bir kişiden verilen inceleme devrini tamamlamasını isteyin
409 too_late_to_cancelGerçek teslimat durumunu inceleyin; iptalin başarılı olduğunu iddia etmeyin
media_expired / media_deletingOrijinalleri yeniden yükleyin ve taslağı güncelleyin
422 validation_failedYapılandırılmış alanları veya hedef başına sorunları düzeltin
429 rate_limitedRetry-After değerine uyun; eşzamanlılığı azaltın ve geri çekilme kullanın
submission_unknownYeni bir gönderim denemeden önce mevcut harici sonucu mutabık kılın

Güvenli mutasyon yeniden denemeleri

İlk mutasyondan önce bir idempotency anahtarı oluşturun ve tam isteğini saklayın. Yanıt kaybolmuşsa işlem zaten başarılı olmuş olabilir. Özdeş isteği aynı anahtarla yeniden gönderin; ağ zaman aşımı nedeniyle asla taze bir anahtar oluşturmayın. MCP mutasyon araçları anahtarlarını yankılar; buna transport_outcome_unknown başarısızlıkları dâhildir. Bağdaştırıcı mutasyonları otomatik yeniden denemez.

Teknik çalışma alanı hız sınırları paylaşım kredisi değildir. Geçerli plan ve hız bilgisi için /usage uçlarını kullanın. Yalnızca geçici hatalar için uygun olduğunda geri çekilin; yetkilendirme, doğrulama veya insan onayı hatalarını nedenini değiştirmeden yeniden denemek fayda sağlamaz.

Kısmi başarı ve gözlem

Kabul edilmiş bir yayın/zamanlama toplu işlemi bağımsız teslimatlardan oluşur. Başarılı makbuzları ve yerel bağlantıları saklayın. Başarısız bir hedefi, tüm toplu işlemi yeniden oluşturmak yerine kendi yeniden deneme uç noktası üzerinden kurtarın. İmzalı webhook'ları tercih edin; yoklama yapıyorsanız artan gecikmelerle sınırlı sayıda deneme yapın ve çözülmemiş işi bir kişiye iletin.