Hatalar

VIDIO API, tutarlı bir hata nesnesi formatı kullanır. Bu sayfayı, yaygın hata türlerini, HTTP durum kodlarını ve API tarafından döndürülen örnek mesajları anlamak için kullanın.

API erişimi şu anda yalnızca Kurumsal planlar için mevcuttur. Kurumsal bir kullanıcı değilseniz ama API’yi kullanmakla ilgileniyorsanız, erişim talep edin buradan.

Genel Bakış

Bir istek başarısız olduğunda, VIDIO API type ve message içeren bir error nesnesi döndürür. Bazı hatalar, başarısızlığı açıklamaya yardımcı olacak ek alanlar da içerebilir.

Hata formatı

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "İşlem bulunamadı"
  }
}

Hata referansı

Status	Type	Message	Description
400	invalid_request_error	Yükleme URL isteğinde gerekli sorgu parametreleri eksik	Gerekli sorgu parametreleri yükleme URL isteğinden eksik olduğunda döndürülür.
400	invalid_request_error	job_id eksik	Render isteği bir iş ID'si içermediğinde döndürülür.
400	invalid_request_error	Bu iş için mevcut çıktı yok	İş, render edilebilir herhangi bir çıktı olmadığında döndürülür.
400	invalid_request_error	input_keys boş olmayan bir dizi olmalıdır	`input_keys` eksik veya boş olduğunda döndürülür.
400	invalid_request_error	input_keys en az bir geçerli girdi anahtarı içermelidir	Tüm sağlanan girdi anahtarları boş veya normalleştirildikten sonra geçersiz olduğunda döndürülür.
400	invalid_request_error	Geçersiz video_category. İzin verilen değerler: podcast, toplu sporlar, toplu olmayan sporlar, güzellik ürünü demosu, düğün, seyahat, diğerleri	`video_category` desteklenmediğinde döndürülür.
400	invalid_request_error	Geçersiz aspect_ratio. İzin verilen değerler: kare, portre, manzara	`aspect_ratio` desteklenmediğinde döndürülür.
400	invalid_request_error	output_length pozitif bir sayı olmalıdır	`output_length` eksik, sıfır veya negatif olduğunda döndürülür.
400	invalid_request_error	input_keys metadata'sından pozitif girdi süresi belirlenemedi	API, yüklenen girdiler için geçerli bir süre belirleyemediğinde döndürülür.
401	authentication_error	API anahtarı eksik	`x-api-key` başlığı sağlanmadığında döndürülür.
401	authentication_error	Geçersiz API anahtarı	Sağlanan API anahtarı aktif bir anahtarla eşleşmediğinde döndürülür.
402	insufficient_balance	Bu işi işlemek için yeterli krediniz yok	Hesap, işleme veya render için yeterli krediye sahip olmadığında döndürülür.
403	permission_error	Bu işe erişim izniniz yok	Kimliği doğrulanmış kullanıcı, talep edilen işi sahiplenmediğinde döndürülür.
403	permission_error	Bu işi render etme izniniz yok	Kimliği doğrulanmış kullanıcı, render edilen işi sahiplenmediğinde döndürülür.
404	invalid_request_error	İş bulunamadı	Talep edilen iş mevcut olmadığında döndürülür.
404	invalid_request_error	Kullanıcı bulunamadı	Kimliği doğrulanmış kullanıcı kaydı bulunamadığında döndürülür.
429	rate_limit_error	Çok fazla talep	Müşteri, uç noktaya izin verilen talep oranını aştığında döndürülür. Mevcut sınır, dakikada 60 talep. Oran sınırlaması, esas olarak x-api-key başlığını kullanan her API anahtarı için uygulanır ve bir API anahtarı yoksa istemci IP adresine geri döner. Bu sınıra ulaşan istemcilerin, istek sıklığını azaltmaları ve oran sınırlama penceresi sıfırlandıktan sonra yeniden denemeleri gerekir.
500	api_error	Kimlik doğrulama hatası	API anahtarı kimlik doğrulaması sunucuda beklenmedik bir şekilde başarısız olduğunda döndürülür.
500	api_error	Dahili sunucu hatası	Durum, render veya vurgu videoları uç noktalarında beklenmedik sunucu tarafı hataları için döndürülür.
500	server_error	Yükleme URL'sini oluşturma başarısız	Sunucu, imzalı bir yükleme URL'si oluşturamadığında döndürülür.