AiVideoEditor
Mulai gratis
Menu

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

Penerbitan dan penjadwalan

Sebuah posting AiVideoEditor memiliki draf berversi dan pengiriman independen untuk akun-akun terpilihnya. Penyimpanan draf bersifat permisif; penyimpanan yang berhasil tidak memastikan bahwa setiap tujuan dapat diterbitkan.

Menyiapkan posting

  1. Baca /api/v1/accounts dan /api/v1/capabilities dengan kunci yang dimaksudkan.
  2. Unggah dan finalisasi media yang diperlukan.
  3. Buat draf dengan POST /api/v1/posts, atau edit dengan PATCH /api/v1/posts/{id}. Sertakan expectedVersion terkini saat mengedit dan pertahankan versi yang dikembalikan.
  4. Atur format tujuan dan penggantian varian eksplisit per akun bila diperlukan. Referensi API mendefinisikan field permintaan.
  5. Validasi dengan POST /api/v1/posts/{id}/validate. HTTP 200 bisa berisi valid: false; periksa setiap isu sebelum mengirim. Akun tidak valid tidak dihapus secara diam-diam dari audiens.

Menerbitkan sekarang atau nanti

POST /posts/{id}/publish mengirimkan draf terkini. POST /posts/{id}/schedule memerlukan scheduledAt, timezone dan expectedVersion. Waktu instan terjadwal harus di masa depan dan dalam 90 hari. Simpan stempel waktu UTC ISO dan zona waktu tampilan IANA terpisah; selesaikan ambiguitas waktu musim panas sebelum mengirim.

Gunakan Idempotency-Key yang berbeda untuk setiap mutasi baru. Pertahankan kunci tersebut dan isi permintaan yang persis sama sebelum mengirim. Setelah timeout, putar ulang permintaan identik dengan kunci yang sama. Ubah kunci hanya saat sengaja meminta operasi baru. Pengeditan atau penjadwalan draf usang mengembalikan revision_conflict; baca ulang dan tinjau konten terbaru alih-alih menimpanya secara membabi buta.

Respons 202 berarti diterima untuk pengiriman. Itu bukan bukti penerbitan. Catat ID pengiriman dan amati GET /posts/{id} atau webhook pelanggan yang ditandatangani. Gunakan polling berbatas dengan jeda yang meningkat; berhenti pada hasil terminal atau serah terima kepada manusia alih-alih berputar tanpa henti.

Hasil per tujuan

Pengiriman dapat selesai secara independen. Satu tujuan mungkin terbit sementara yang lain perlu sambung ulang atau persetujuan. Tampilkan setiap status dan tautan posting asli bila ada. Coba ulang hanya kegagalan yang diketahui dan memenuhi syarat menggunakan POST /deliveries/{id}/retry. Tujuan yang berhasil tidak boleh dibuat ulang untuk memulihkan tujuan yang gagal. Hasil eksternal yang tidak diketahui perlu rekonsiliasi atau peninjauan, bukan pengiriman baru.

Batalkan dengan POST /deliveries/{id}/cancel selama pekerjaan masih belum diambil secara aman. too_late_to_cancel berarti pengiriman telah melewati batas pembatalan yang aman; itu tidak berarti posting eksternal telah dihapus.

Peninjauan manusia TikTok

Baca /accounts/{id}/tiktok/settings untuk pengaturan creator terkini dan pilihan privasi yang tersedia. Pembacaan pengaturan atau penyimpanan draf tidak memberikan persetujuan. consent_required menyertakan serah terima requiresAction yang aman ke komposer terautentikasi. Orang yang berwenang meninjau video, takarir, dan tujuan secara persis dan mengonfirmasi pilihan yang diwajibkan secara eksplisit di sana. Kunci produk dan alat MCP tidak dapat mengonfirmasi atas namanya. Perubahan konten atau identitas memerlukan peninjauan baru. Serah terima itu sendiri tidak memberikan keanggotaan atau akses.

Kontrol komposer

Gunakan Add media untuk mengunggah berkas atau memilih item pustaka yang ada. Takarir dibagi bersama hingga Customize content membuat varian khusus akun. Alat emoji dan hashtag menyisipkan teks biasa pada kursor.

Posting options mengelompokkan pengaturan akun terpilih. Pilihan wajib tetap terlihat; grup opsional tetap terlipat. Perubahan hanya berlaku untuk akun tersebut. Preview menampilkan draf efektif tanpa menyimpan atau mengirimkannya, termasuk draf yang belum lengkap; tampilan platform asli bisa berbeda.

Gunakan referensi aset privat untuk sampul dan thumbnail terjadwal. Alternatif URL publik harus tetap dapat dijangkau pada saat pengiriman. Konten subtitel disimpan bersama pengaturan yang tidak dapat diubah alih-alih bergantung pada berkas lokal sementara. Unggahan dokumen LinkedIn saat ini menerima PDF; format Office tetap dibatasi sampai validasi tanda tangan diimplementasikan.

Lihat referensi kemampuan untuk kontrol kanonik dan batasan integrasi. Perilaku format dan konfirmasi baru memerlukan migrasi basis data terkait sebelum deployment.