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 Studio planı ve üzeri için mevcuttur.

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	Yükleme URL isteğinde gerekli sorgu parametreleri eksik olduğunda döndürülür.
400	invalid_request_error	Eksik job_id	Render isteğinde job ID bulunmadığında döndürülür.
400	invalid_request_error	Bu iş için çıktı bulunmuyor	İşin renderlanabilir herhangi bir çıktısı 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 input key içermelidir	Verilen tüm input key'ler normalizasyondan sonra boş veya geçersiz olduğunda döndürülür.
400	input_duration_requirement_error	Toplam giriş süresi 2 saniyeden fazla olmalıdır	Tüm giriş medyalarının birleşik süresi 2 saniye veya daha az olduğunda döndürülür.
400	input_duration_requirement_error	Toplam giriş süresi 6 saatten az olmalıdır	Tüm giriş medyalarının birleşik süresi 6 saat veya daha fazla olduğunda döndürülür.
400	input_image_count_requirement_error	Girdi resim sayısı en fazla 4000 olmalıdır	Girdi resim sayısı izin verilen maksimum 4000 sınırını aştığında döndürülür.
400	input_video_count_requirement_error	Girdi video sayısı en fazla 400 olmalıdır	Girdi video sayısı izin verilen maksimum 400 sınırını aştığında döndürülür.
400	invalid_request_error	Geçersiz video_category. İzin verilen değerler: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	`video_category` desteklenmiyorsa döndürülür.
400	invalid_request_error	Geçersiz aspect_ratio. İzin verilen değerler: square, portrait, landscape	`aspect_ratio` desteklenmiyorsa 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 giriş süresi belirlenemedi	API yüklenen girdiler için geçerli bir süre belirleyemediğinde döndürülür.
400	invalid_request_error	music_volume 0 ile 100 arasında bir sayı olmalıdır	`music_volume` sağlanmış ancak 0 ile 100 arasında geçerli bir sayı olmadığında döndürülür.
400	invalid_request_error	original_audio_volume 0 ile 100 arasında bir sayı olmalıdır	`original_audio_volume` sağlanmış ancak 0 ile 100 arasında geçerli bir sayı olmadığında döndürülür.
400	invalid_request_error	Geçersiz music_category. İzin verilen değerler: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	`music_category` sağlanmış ancak desteklenen müzik kategorilerinden biriyle eşleşmediğ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ı etkin bir anahtarla eşleşmediğinde döndürülür.
402	insufficient_balance	Bu işi işlemek için yeterli krediniz yok	Hesabın işleme veya render için yeterli kredisi olmadığında döndürülür.
403	permission_error	Bu işe erişim izniniz yok	Kimlik doğrulaması yapılmış kullanıcı istenen işe sahip olmadığında döndürülür.
403	permission_error	Bu işi render etme izniniz yok	Kimlik doğrulaması yapılmış kullanıcı renderlanan işe sahip olmadığında döndürülür.
404	invalid_request_error	İş bulunamadı	İstenen iş mevcut değilse döndürülür.
404	invalid_request_error	Kullanıcı bulunamadı	Kimlik doğrulanmış kullanıcı kaydı bulunamadığında döndürülür.
429	rate_limit_error	Çok fazla istek	İstemci, uç nokta için izin verilen istek hızını aştığında döndürülür. Mevcut limit dakika başına 60 istektir. Oran sınırlaması öncelikle x-api-key başlığıyla sağlanan API anahtarına göre uygulanır; API anahtarı yoksa istemci IP adresine göre uygulanır. Bu limite takılan istemciler istek sıklığını azaltmalı ve oran sınırı penceresi sıfırlandıktan sonra yeniden denemelidir.
429	rate_limit_error	Zaten 10 çalışan veya kuyruğa alınmış işiniz var; bu izin verilen maksimumdur. Lütfen başka bir iş göndermeden önce bazı işlerin bitmesini bekleyin.	Kullanıcı zaten sunucularda çalışan işler ve kuyruğundaki bekleyen işler dahil olmak üzere izin verilen maksimum sayıda devam eden işe sahip olduğunda döndürülür. Mevcut limit kullanıcı başına toplam 10 çalışan veya kuyruğa alınmış iştir. Sahiplik, meşgul sunuculardaki ve bekleyen kuyruk girdilerindeki her job_id'yi işin user_email alanıyla eşleştirerek belirlenir. Bu limite takılan istemciler yeni bir iş oluşturmak veya render etmek yerine mevcut işlerden bir veya birkaçının tamamlanmasını beklemelidir.
500	api_error	Kimlik doğrulama hatası	API anahtarı kimlik doğrulaması sunucuda beklenmedik şekilde başarısız olduğunda döndürülür.
500	api_error	Dahili sunucu hatası	Durum, render veya highlight reel uç noktalarında beklenmeyen sunucu tarafı hatalar için döndürülür.
500	server_error	Yükleme URL'si oluşturulamadı	Sunucu imzalı bir yükleme URL'si oluşturamadığında döndürülür.