MasukMulai uji coba gratis
easyCoexistence API resmi

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.

reason

Kolom /business/publish/status/ hanya muncul saat status FAILED, dengan nilai seperti frame_rate_check_failed.

fail_reason

Nama kolom yang sama pada Content Posting API, di respons /v2/post/publish/status/fetch/.

1 hour

Batas waktu unduhan, setelah itu TikTok menggagalkan unggahan dengan video_pull_failed atau photo_pull_failed.

24 hours

Jendela waktu di balik spam_risk_too_many_posts; TikTok menyarankan agar unggahan itu dipublikasikan dari aplikasi seluler.

3 hours

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:

A failed post in /business/publish/status/, from TikTok's example
{
  "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 foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing 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_failed atau photo_pull_failed setelah URL bersifat publik dan cukup cepat.
  • Coba kembali dengan berkas baru: file_format_check_failed, duration_check_failed, frame_rate_check_failed dan picture_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_removed dan spam_risk, sebagaimana disarankan TikTok, atau spam_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_URL dari domain atau prefiks yang belum diverifikasi aplikasi.
  • privacy_level_option_mismatch: privacy_level hilang 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.

Failed posts through MCP
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.
Melakukan ini dengan EasyCoexistence

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