AiVideoEditor
Mulai gratis
Menu

Ditinjau 2026-11-10 · Versi API 2026-11-09 · Baca Markdown

Kesalahan, percobaan ulang, dan pemulihan

Kesalahan API menggunakan { "error": { "code": "…", "message": "…", "requestId": "…" } } dengan kesalahan field opsional, kesalahan tujuan, petunjuk percobaan ulang, dan serah terima tindakan. Simpan requestId untuk dukungan. Jangan mencatat kredensial, URL unggahan bertanda tangan, atau isi permintaan yang sensitif saat mengumpulkan diagnostik.

ResponsPemulihan
401 unauthenticatedPeriksa kunci produk yang hilang, rusak formatnya, atau dicabut
403 forbidden_scope / account_not_allowedTinjau cakupan kunci dan akses tujuan
402 account_limit, seat_limit, storage_limitTinjau hak ruang kerja dan penggunaan sumber daya
402 subscription_inactive / trial_expiredSelesaikan status penagihan; pertahankan draf dan pekerjaan dalam antrean
409 revision_conflictBaca versi terkini, tinjau perubahan, dan terapkan ulang secara sengaja
409 idempotency_conflictKunci digunakan ulang dengan isi berbeda; rekonsiliasi operasi aslinya
409 consent_requiredMinta orang berwenang menyelesaikan serah terima peninjauan yang diberikan
409 too_late_to_cancelPeriksa status pengiriman sebenarnya; jangan klaim pembatalan berhasil
media_expired / media_deletingUnggah ulang berkas asli dan perbarui draf
422 validation_failedPerbaiki field terstruktur atau isu per tujuan
429 rate_limitedHormati Retry-After; kurangi konkurensi dan gunakan backoff
submission_unknownRekonsiliasi hasil eksternal yang ada sebelum mencoba pengiriman lain

Percobaan ulang mutasi yang aman

Buat kunci idempotensi sebelum mutasi pertama dan simpan permintaan persisnya. Jika respons hilang, operasi mungkin sudah berhasil. Putar ulang permintaan yang sama dengan kunci yang sama; jangan membuat kunci baru hanya karena jaringan timeout. Alat mutasi MCP menampilkan kuncinya kembali, termasuk pada kegagalan transport_outcome_unknown. Adaptor tidak mencoba ulang mutasi secara otomatis.

Batas kecepatan teknis ruang kerja bukanlah kredit posting. Gunakan /usage untuk informasi paket dan laju terkini. Mundur hanya untuk kesalahan sementara bila memang tepat; mencoba ulang kesalahan otorisasi, validasi, atau persetujuan manusia tanpa mengubah penyebabnya tidak akan membantu.

Keberhasilan parsial dan pengamatan

Batch publish/schedule yang diterima adalah kumpulan pengiriman independen. Simpan tanda terima yang berhasil dan tautan asli. Pulihkan tujuan yang gagal melalui endpoint percobaan ulangnya sendiri alih-alih membuat ulang seluruh batch. Utamakan webhook bertanda tangan; jika polling, gunakan jumlah percobaan berbatas dengan jeda yang meningkat dan eskalasikan pekerjaan yang belum selesai kepada orang.