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 hanya tersedia untuk rencana Enterprise. Minta akses di sini jika Anda bukan pengguna Enterprise tetapi tertarik menggunakan API.

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 hilang	Dikembalikan ketika permintaan render tidak menyertakan ID pekerjaan.
400	invalid_request_error	Tidak ada output yang 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 mengandung setidaknya satu kunci input yang valid	Dikembalikan ketika semua kunci input yang diberikan kosong atau tidak valid setelah normalisasi.
400	invalid_request_error	video_category tidak valid. Nilai yang diperbolehkan: podcast, olah raga bola, olah raga non-bola, demo produk kecantikan, pernikahan, perjalanan, lain-lain	Dikembalikan ketika `video_category` tidak didukung.
400	invalid_request_error	aspect_ratio tidak valid. Nilai yang diperbolehkan: persegi, potret, lanskap	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 positif dari metadata input_keys	Dikembalikan ketika API tidak dapat menentukan durasi yang valid untuk input yang diunggah.
401	authentication_error	Kunci API hilang	Dikembalikan ketika header `x-api-key` tidak disediakan.
401	authentication_error	Kunci API tidak valid	Dikembalikan ketika kunci API yang diberikan tidak cocok dengan kunci yang aktif.
402	insufficient_balance	Anda tidak memiliki cukup kredit untuk memproses pekerjaan ini	Dikembalikan ketika akun tidak memiliki cukup kredit untuk pengolahan atau rendering.
403	permission_error	Anda tidak memiliki izin untuk mengakses pekerjaan ini	Dikembalikan ketika pengguna yang terautentikasi tidak memiliki pekerjaan yang diminta.
403	permission_error	Anda tidak memiliki izin untuk merender pekerjaan ini	Dikembalikan ketika pengguna yang terautentikasi tidak memiliki 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 yang terautentikasi tidak dapat ditemukan.
429	rate_limit_error	Terlalu banyak permintaan	Dikembalikan ketika klien melebihi batas permintaan yang diizinkan untuk endpoint. Batas saat ini adalah 60 permintaan per menit. Pembatasan laju terutama diterapkan per kunci API menggunakan header x-api-key, dan jatuh kembali ke alamat IP klien saat kunci API tidak ada. Klien yang mencapai batas ini harus mengurangi frekuensi permintaan dan mencoba lagi setelah jendela pembatasan laju direset.
500	api_error	Kesalahan otentikasi	Dikembalikan ketika otentikasi kunci API gagal secara tidak terduga di server.
500	api_error	Kesalahan server internal	Dikembalikan untuk kegagalan yang tidak terduga di sisi server dalam status, render, atau endpoint highlight reel.
500	server_error	Gagal menghasilkan URL unggah	Dikembalikan ketika server gagal menghasilkan URL unggah yang ditandatangani.