Kesalahan

API VIDIO menggunakan format objek kesalahan yang konsisten. Gunakan halaman ini untuk memahami jenis kesalahan umum, kode status HTTP, dan pesan contoh yang dikembalikan oleh API.

Akses API saat ini tersedia untuk rencana Studio dan di atasnya.

Gambaran Umum

Ketika permintaan gagal, API VIDIO mengembalikan objek error dengan type dan message. Beberapa kesalahan mungkin juga menyertakan bidang tambahan untuk membantu menjelaskan kegagalan.

Format Kesalahan

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Pekerjaan tidak ditemukan"
  }
}

Referensi Kesalahan

Status	Type	Message	Description
400	invalid_request_error	Parameter kueri yang diperlukan hilang dalam permintaan URL unggah	Dikembalikan ketika parameter kueri yang diperlukan hilang dari permintaan URL unggah.
400	invalid_request_error	job_id tidak ditemukan	Dikembalikan ketika permintaan render tidak menyertakan ID pekerjaan.
400	invalid_request_error	Tidak ada output tersedia untuk pekerjaan ini	Dikembalikan ketika pekerjaan tidak memiliki output yang dapat dirender.
400	invalid_request_error	`input_keys` harus berupa array yang tidak kosong	Dikembalikan ketika `input_keys` hilang atau kosong.
400	invalid_request_error	`input_keys` harus berisi setidaknya satu input key yang valid	Dikembalikan ketika semua input key yang diberikan kosong atau tidak valid setelah normalisasi.
400	input_duration_requirement_error	Total durasi input harus lebih dari 2 detik	Dikembalikan ketika durasi gabungan semua media input adalah 2 detik atau kurang.
400	input_duration_requirement_error	Total durasi input harus kurang dari 6 jam	Dikembalikan ketika durasi gabungan semua media input adalah 6 jam atau lebih.
400	input_image_count_requirement_error	Jumlah gambar input tidak boleh lebih dari 4000	Dikembalikan ketika jumlah gambar input melebihi batas maksimum yang diizinkan yaitu 4000.
400	input_video_count_requirement_error	Jumlah video input tidak boleh lebih dari 400	Dikembalikan ketika jumlah video input melebihi batas maksimum yang diizinkan yaitu 400.
400	invalid_request_error	`video_category` tidak valid. Nilai yang diizinkan: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Dikembalikan ketika `video_category` tidak didukung.
400	invalid_request_error	`aspect_ratio` tidak valid. Nilai yang diizinkan: square, portrait, landscape	Dikembalikan ketika `aspect_ratio` tidak didukung.
400	invalid_request_error	`output_length` harus berupa angka positif	Dikembalikan ketika `output_length` hilang, nol, atau negatif.
400	invalid_request_error	Tidak dapat menentukan durasi input yang positif dari metadata `input_keys`	Dikembalikan ketika API tidak dapat menentukan durasi yang valid untuk input yang diunggah.
400	invalid_request_error	`music_volume` harus berupa angka antara 0 dan 100	Dikembalikan ketika `music_volume` diberikan tetapi bukan angka yang valid antara 0 dan 100.
400	invalid_request_error	`original_audio_volume` harus berupa angka antara 0 dan 100	Dikembalikan ketika `original_audio_volume` diberikan tetapi bukan angka yang valid antara 0 dan 100.
400	invalid_request_error	`music_category` tidak valid. Nilai yang diizinkan: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Dikembalikan ketika `music_category` diberikan tetapi tidak cocok dengan salah satu kategori musik yang didukung.
401	authentication_error	Kunci API tidak disertakan	Dikembalikan ketika header `x-api-key` tidak disertakan.
401	authentication_error	Kunci API tidak valid	Dikembalikan ketika kunci API yang diberikan tidak cocok dengan kunci aktif.
402	insufficient_balance	Anda tidak memiliki kredit yang cukup untuk memproses pekerjaan ini	Dikembalikan ketika akun tidak memiliki kredit yang cukup untuk pemrosesan atau rendering.
403	permission_error	Anda tidak memiliki izin untuk mengakses pekerjaan ini	Dikembalikan ketika pengguna terautentikasi bukan pemilik pekerjaan yang diminta.
403	permission_error	Anda tidak memiliki izin untuk merender pekerjaan ini	Dikembalikan ketika pengguna terautentikasi bukan pemilik pekerjaan yang sedang dirender.
404	invalid_request_error	Pekerjaan tidak ditemukan	Dikembalikan ketika pekerjaan yang diminta tidak ada.
404	invalid_request_error	Pengguna tidak ditemukan	Dikembalikan ketika catatan pengguna terautentikasi tidak dapat ditemukan.
429	rate_limit_error	Terlalu banyak permintaan	Dikembalikan ketika klien melebihi batas laju permintaan yang diizinkan untuk endpoint. Batas saat ini adalah 60 permintaan per menit. Pembatasan laju diterapkan terutama per kunci API menggunakan header `x-api-key`, dan menggunakan alamat IP klien jika kunci API tidak ada. Klien yang mencapai batas ini harus mengurangi frekuensi permintaan dan mencoba lagi setelah jendela pembatasan laju direset.
429	rate_limit_error	Anda sudah memiliki 10 pekerjaan yang sedang berjalan atau antre, yang merupakan batas maksimum. Harap tunggu beberapa pekerjaan selesai sebelum mengirim yang lain.	Dikembalikan ketika pengguna sudah memiliki jumlah maksimum pekerjaan yang sedang diproses (berjalan atau antre) di seluruh server dan antrean. Batas saat ini adalah 10 pekerjaan berjalan atau antre per pengguna. Kepemilikan ditentukan dengan mencocokkan setiap job_id pada server yang sibuk dan entri antrean yang tertunda dengan user_email pekerjaan tersebut. Klien yang mencapai batas ini harus menunggu satu atau lebih pekerjaan yang ada selesai sebelum membuat atau merender pekerjaan lain.
500	api_error	Kesalahan otentikasi	Dikembalikan ketika otentikasi kunci API gagal secara tak terduga di server.
500	api_error	Kesalahan server internal	Dikembalikan untuk kegagalan sisi server yang tak terduga pada endpoint status, render, atau highlight reel.
500	server_error	Gagal menghasilkan URL unggah	Dikembalikan ketika server gagal menghasilkan URL unggah yang ditandatangani.