Kegagalan Publikasi TikTok: spam_risk_too_many_posts, picture_size_check_failed dan Alasan Gagal Lainnya
TikTok mencatat penyebab unggahan yang gagal di kolom reason, pada endpoint status API for Business, atau di kolom fail_reason pada Content Posting API. Kegagalan pemeriksaan seperti picture_size_check_failed berarti berkas melanggar aturan format dan harus diganti; video_pull_failed berarti TikTok tidak dapat mengunduh berkas dalam satu jam; spam_risk_too_many_posts berarti terlalu banyak unggahan API dalam 24 jam. Kegagalan yang ditandai internal cukup dicoba kembali.
easyCoexistence mengikuti setiap unggahan TikTok yang dipublikasikannya hingga TikTok menyelesaikan atau menggagalkannya, untuk Claude, ChatGPT atau platform Anda sendiri: kegagalan tiba beserta alasan TikTok lewat email, di layar Posts dan sebagai event post.failed, siap dicoba kembali.
Kolom /business/publish/status/ hanya muncul saat status FAILED, dengan nilai seperti frame_rate_check_failed.
Nama kolom yang sama pada Content Posting API, di respons /v2/post/publish/status/fetch/.
Batas waktu unduhan, setelah itu TikTok menggagalkan unggahan dengan video_pull_failed atau photo_pull_failed.
Jendela waktu di balik spam_risk_too_many_posts; TikTok menyarankan agar unggahan itu dipublikasikan dari aplikasi seluler.
Paling sering easyCoexistence mengirim email kepada pemilik tentang unggahan gagal di satu saluran; unggahan menunggu di bawah Perlu perhatian.
Di mana TikTok melaporkan alasan unggahan gagal?
Setelah panggilan publikasi, yang hanya memulai tugas: kode 0 berarti TikTok menerimanya, bukan bahwa unggahan akan tayang. GET /business/publish/status/ kemudian membaca FAILED dengan reason, dan aplikasi yang berlangganan webhook publikasi menerima post.publish.failed dengan alasan yang sama serta publish_id. /v2/post/publish/status/fetch/ pada Content Posting API mengembalikan kolom itu sebagai fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Apa arti setiap alasan kegagalan, dan bagaimana memperbaikinya?
Alasan TikTok, sebagaimana dijelaskan dalam referensi event publikasi unggahannya, beserta solusi yang ditunjuknya. Empat yang pertama adalah pemeriksaan TikTok terhadap berkas setelah diunduh, yang semuanya ditandai tidak dapat dicoba kembali. Tabel kegagalan TikTok masih menyebut 60 detik sebagai video terpanjang untuk duration_check_failed, sementara endpoint video mendokumentasikan 600, atau max_video_post_duration_sec milik akun:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
Kegagalan mana yang dapat dicoba kembali?
Yang disebabkan oleh pengunduhan atau oleh TikTok sendiri. Sisanya memerlukan berkas atau caption yang berbeda, jeda, atau tidak ada tindakan sama sekali:
- Coba kembali apa adanya: internal, dan
video_pull_failedatauphoto_pull_failedsetelah URL bersifat publik dan cukup cepat. - Coba kembali dengan berkas baru:
file_format_check_failed,duration_check_failed,frame_rate_check_faileddanpicture_size_check_failed. - Coba kembali dengan caption baru:
spam_risk_text. - Tunggu, atau publikasikan dari aplikasi TikTok:
spam_risk_too_many_posts. - Jangan dicoba kembali:
auth_removeddanspam_risk, sebagaimana disarankan TikTok, atauspam_risk_user_banned_from_posting.
Bagaimana kegagalan Content Posting API berbeda?
Alasannya sama, tetapi kolom dan endpoint-nya berbeda, serta ada penolakan yang terjadi sebelum pemrosesan dimulai. /v2/post/publish/status/fetch/ mengembalikan fail_reason, mengizinkan 30 permintaan per menit per token pengguna, dan menambahkan saran jangan dicoba kembali untuk spam_risk_user_banned_from_posting dan spam_risk_text. Beberapa penolakan muncul pada panggilan init sebagai gantinya, dengan HTTP 403:
spam_risk_too_many_posts: kreator mencapai batas unggahan harian API.unaudited_client_can_only_post_to_private_accounts: aplikasi yang belum diaudit mencoba mengunggah untuk akun publik.url_ownership_unverified:PULL_FROM_URLdari domain atau prefiks yang belum diverifikasi aplikasi.privacy_level_option_mismatch:privacy_levelhilang atau di luar pilihan kreator.reached_active_user_cap: aplikasi mencapai kuota harian pengguna publikasi aktif.
Apa yang gagal sebelum TikTok melihat unggahan?
Hal-hal yang dapat ditangkap easyCoexistence lebih dulu, dengan pesan sendiri, bukan alasan TikTok. Media unggahan terjadwal disalin saat dijadwalkan, dan tautan yang mengembalikan halaman web, 404, tipe yang salah, atau berkas lebih dari 30 MB untuk gambar atau 1 GB untuk video ditolak saat itu. Tautan foto yang berakhiran .png, .gif, .bmp, .heic, .avif atau .svg ditolak sebelum apa pun dikirim, saluran yang perlu dihubungkan ulang saat unggahan dikirim gagal dengan kategori reconnect, dan menghapus saluran membatalkan unggahan terjadwalnya.
Bagaimana easyCoexistence melaporkan unggahan TikTok yang gagal?
Melalui antrean publikasinya, yang mengikuti setiap unggahan TikTok setelah panggilan publikasi, memeriksa /business/publish/status/ sekitar setiap 20 detik hingga PUBLISH_COMPLETE. Status FAILED menggagalkan unggahan, dengan kesalahan yang menyebut alasan TikTok di dalam tanda kurung, seperti frame_rate_check_failed, dan setiap kegagalan membawa failure_kind:
- refused: TikTok menjawab tidak, seperti pada status FAILED dan alasannya.
- uncertain: panggilan publikasi tidak mendapat jawaban yang jelas, atau TikTok tidak memberi konfirmasi dalam 2 jam, sehingga unggahan mungkin sudah tayang (
may_be_published). - reconnect: TikTok menolak token akun, dan akun perlu masuk ulang.
- internal: easyCoexistence gagal sebelum menyerahkan unggahan, sehingga tidak ada yang terkirim.
Bagaimana cara menemukan dan mencoba kembali unggahan yang gagal?
Pemilik menerima email untuk kegagalan yang ditemukan di latar belakang, paling banyak satu per saluran setiap 3 jam, dan URL event milik platform menerima post.failed. Unggahan muncul di bawah Perlu perhatian pada layar Posts, dengan tombol Coba lagi, Hubungkan ulang dan Abaikan, dan list_scheduled_posts mengembalikannya ke Claude atau ChatGPT. retry_scheduled_post mempublikasikannya lagi, sekarang, dari berkas yang disimpan 7 hari setelah kegagalan; jika may_be_published bernilai true, periksa list_social_posts terlebih dahulu dan isi confirm hanya jika unggahan itu tidak ada. Unggahan yang memerlukan berkas atau caption baru dijadwalkan ulang sebagai gantinya.
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }Kesalahan umum
- Mencoba kembali kegagalan pemeriksaan dengan berkas yang sama. TikTok menandai kegagalan format, durasi, frame rate dan ukuran gambar sebagai tidak dapat dicoba kembali.
- Langsung mencoba kembali spam_risk_too_many_posts. TikTok menghitung unggahan API dalam 24 jam dan menyarankan publikasi dari aplikasi seluler.
- Mencoba kembali unggahan yang ditandai may_be_published tanpa memeriksanya. TikTok mungkin sudah mempublikasikannya; periksa unggahan terbaru akun, atau unggahan itu akan terkirim dua kali.
- Mencari fail_reason di API for Business. Endpoint status-nya menamai kolom itu reason; fail_reason termasuk Content Posting API.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apa arti picture_size_check_failed di TikTok?
TikTok mengunduh unggahan dan mendapati gambarnya di bawah minimum 360 piksel tinggi dan lebar; berkas yang lebih besar diperlukan, karena TikTok menandai kegagalan ini sebagai tidak dapat dicoba kembali.
Apa itu video_pull_failed?
TikTok tidak dapat mengunduh video dari URL-nya, atau tidak dalam batas waktu satu jam. Periksa bahwa URL bersifat publik dan tidak dibatasi bandwidth-nya, lalu coba kembali.
Berapa lama spam_risk_too_many_posts berlangsung?
TikTok menghitung unggahan yang dibuat lewat API dalam 24 jam terakhir, sekitar 15 per hari per akun, dan selama itu menyarankan publikasi dari aplikasi seluler TikTok.
Apakah easyCoexistence mencoba kembali unggahan TikTok yang gagal dengan sendirinya?
Tidak setelah TikTok melaporkan FAILED: unggahan menunggu di bawah Perlu perhatian dan pemilik diberi tahu lewat email, lalu Coba lagi atau retry_scheduled_post mengirimnya kembali.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada