Ditinjau 2026-11-10 · Versi API 2026-11-09 · Baca Markdown
Autentikasi dan kunci produk
UI, REST API, dan adaptor MCP AiVideoEditor berbagi layanan ruang kerja. Klien API
menggunakan kunci produk, bukan token OAuth jaringan sosial atau kredensial basis data.
Buat kunci di /app/developers setelah masuk ke ruang kerja yang benar. Salin
kunci teks biasa pk_v1_… satu kali dan simpan di manajer rahasia atau lingkungan
lokal yang terlindungi. AiVideoEditor menyimpan hash dan prefiks tampilan.
Mengirim kunci
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Gunakan HTTPS untuk origin yang di-deploy. Jauhkan kredensial dari URL, kontrol sumber, prompt obrolan, tangkapan layar, dan log. Unggahan penyimpanan langsung menggunakan URL bertanda tangan dan header yang dikembalikan; jangan meneruskan bearer key AiVideoEditor Anda ke penyimpanan.
Cakupan dan akses akun
| Cakupan | Kemampuan |
|---|---|
accounts:read | Memeriksa akun, kemampuan, dan pengaturan TikTok |
media:write | Mencadangkan, memfinalisasi, dan mengelola unggahan |
posts:read | Mendaftar posting, memvalidasi draf, dan mengamati status |
posts:write | Membuat dan mengedit draf |
posts:publish | Menerbitkan, menjadwalkan, membatalkan, dan mencoba ulang pengiriman |
usage:read | Membaca penggunaan ruang kerja dan informasi paket |
webhooks:manage | Mendaftarkan, mendaftar, dan menghapus endpoint webhook |
Cakupan adalah nama yang tepat, bukan hierarki. Berikan hanya yang dibutuhkan integrasi.
Kunci juga dapat membatasi ID akun yang dapat diakses. Keanggotaan ruang kerja, peran
efektif, pembatasan akun, dan status paket tetap berlaku. Kunci dengan
posts:publish tidak otomatis mendapatkan akses penulisan draf.
Set cakupan kunci bawaan tidak menyertakan posts:publish dan webhooks:manage. Agen
khusus draf dapat menyiapkan pekerjaan untuk ditinjau tanpa kewenangan mengirimkannya. Kunci
tidak dapat membuat kunci lain atau mengubah penagihan.
Pencabutan dan pemulihan
Cabut kunci yang terkompromi di UI pengembang. Tinjau jumlah pekerjaan tertundanya
terlebih dahulu: pencabutan menjeda pekerjaan yang belum terkirim sebagai requires_action; ia tidak
menghapus draf. Buat pengganti dengan akses yang sesuai dan tinjau pekerjaan tertunda
sebelum melanjutkan. Jangan berasumsi pencabutan dapat menarik kirim an yang sudah terkirim ke luar.
401 berarti kredensial tidak ada atau tidak valid. 403 berarti aktor
terautentikasi tidak memiliki izin atau akses akun. Mencoba ulang salah satu respons
itu berulang kali tidak akan memperbaikinya. Lihat kesalahan dan pemulihan.