Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Kegagalan siaran TikTok: spam_risk_too_many_posts, picture_size_check_failed dan sebab kegagalan lain

TikTok menamakan punca siaran yang gagal dalam medan reason, pada endpoint status API perniagaan TikTok, atau sebagai fail_reason dalam Content Posting API. Kegagalan semakan seperti picture_size_check_failed bermakna fail melanggar peraturan format dan perlu diubah; video_pull_failed bermakna TikTok tidak dapat memuat turunnya dalam masa sejam; spam_risk_too_many_posts bermakna terlalu banyak siaran API dalam tempoh 24 jam. Kegagalan yang ditandakan sebagai internal boleh dicuba semula begitu sahaja.

easyCoexistence menjejaki setiap siaran TikTok yang diterbitkannya sehingga TikTok melengkapkan atau menggagalkannya, untuk Claude, ChatGPT atau platform anda sendiri: kegagalan tiba dengan sebab TikTok melalui e-mel, pada skrin Siaran dan sebagai peristiwa post.failed, sedia untuk dicuba semula.

reason

Medan /business/publish/status/ hanya dikembalikan apabila status ialah FAILED, dengan nilai seperti frame_rate_check_failed.

fail_reason

Nama medan yang sama dalam Content Posting API, dalam respons /v2/post/publish/status/fetch/.

1 hour

Tempoh tamat muat turun, selepas itu TikTok menggagalkan siaran dengan video_pull_failed atau photo_pull_failed.

24 hours

Tempoh di sebalik spam_risk_too_many_posts; TikTok mencadangkan siaran itu diterbitkan dari aplikasi mudah alihnya sebaliknya.

3 hours

Selalunya easyCoexistence menghantar e-mel kepada pemilik mengenai siaran yang gagal pada satu saluran; siaran itu menunggu di bawah Perlu perhatian.

Di mana TikTok melaporkan sebab siaran gagal?

Selepas panggilan terbitan, yang hanya memulakan tugas: kod 0 bermaksud TikTok menerimanya, bukan bahawa siaran itu akan tersiar. GET /business/publish/status/ kemudian membaca FAILED dengan reason, dan aplikasi yang melanggan webhook penerbitan menerima post.publish.failed dengan sebab yang sama serta publish_id. /v2/post/publish/status/fetch/ bagi Content Posting API memulangkan medan 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"
  }
}

Apakah maksud setiap sebab kegagalan, dan apakah pembetulannya?

Sebab-sebab TikTok, seperti yang diterangkan dalam rujukan peristiwa siaran terbitannya, bersama pembetulan yang ditunjuk oleh setiap satu. Empat yang pertama ialah semakan yang TikTok jalankan ke atas fail selepas memuat turunnya, semuanya ditandakan tidak boleh dicuba semula. Jadual kegagalan TikTok masih memberikan 60 saat sebagai video terpanjang bagi duration_check_failed, manakala endpoint video mendokumentasikan 600, atau max_video_post_duration_sec akaun itu sendiri:

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 boleh dicuba semula?

Yang disebabkan oleh muat turun atau oleh TikTok sendiri. Yang lain memerlukan fail atau kapsyen yang berbeza, jeda, atau tiada tindakan langsung:

  • Cuba semula seperti sedia ada: internal, dan video_pull_failed atau photo_pull_failed apabila URL sudah awam dan cukup pantas.
  • Cuba semula dengan fail baharu: file_format_check_failed, duration_check_failed, frame_rate_check_failed dan picture_size_check_failed.
  • Cuba semula dengan kapsyen baharu: spam_risk_text.
  • Tunggu, atau siarkan dari aplikasi TikTok: spam_risk_too_many_posts.
  • Jangan cuba semula: auth_removed dan spam_risk, seperti yang dinasihatkan TikTok, atau spam_risk_user_banned_from_posting.

Bagaimana kegagalan Content Posting API berbeza?

Sebab yang sama, medan dan endpoint yang berbeza, serta penolakan yang berlaku sebelum pemprosesan bermula. /v2/post/publish/status/fetch/ memulangkan fail_reason, membenarkan 30 permintaan seminit bagi setiap token pengguna, dan menambah nasihat jangan cuba semula untuk spam_risk_user_banned_from_posting dan spam_risk_text. Beberapa penolakan tiba pada panggilan init, dengan HTTP 403:

  • spam_risk_too_many_posts: pencipta mencapai had siaran harian API.
  • unaudited_client_can_only_post_to_private_accounts: aplikasi yang tidak diaudit cuba menyiarkan untuk akaun awam.
  • url_ownership_unverified: PULL_FROM_URL daripada domain atau awalan yang belum disahkan oleh aplikasi.
  • privacy_level_option_mismatch: privacy_level tiada atau berada di luar pilihan pencipta.
  • reached_active_user_cap: aplikasi mencapai kuota harian pengguna penerbitan aktif.

Apakah yang gagal sebelum TikTok melihat siaran?

Apa yang easyCoexistence boleh tangkap dahulu, dengan mesej tersendiri dan bukan sebab TikTok. Media siaran berjadual disalin pada masa dijadualkan, dan pautan yang memulangkan halaman web, 404, jenis yang salah, atau fail melebihi 30 MB untuk imej atau 1 GB untuk video ditolak pada ketika itu. Pautan foto yang berakhir dengan .png, .gif, .bmp, .heic, .avif atau .svg ditolak sebelum apa-apa dihantar, saluran yang perlu disambung semula pada masa siaran gagal dengan reconnect, dan membuang saluran membatalkan siaran berjadualnya.

Bagaimana easyCoexistence melaporkan siaran TikTok yang gagal?

Melalui barisan siaran, yang menjejaki setiap siaran TikTok selepas panggilan terbitan, dengan menyemak /business/publish/status/ kira-kira setiap 20 saat sehingga PUBLISH_COMPLETE. Status FAILED menggagalkan siaran itu, dengan ralat yang menamakan sebab TikTok dalam kurungan, seperti frame_rate_check_failed, dan setiap kegagalan membawa failure_kind:

  • refused: TikTok menjawab tidak, seperti dengan status FAILED dan sebabnya.
  • uncertain: panggilan terbitan tidak mendapat jawapan yang jelas, atau TikTok tidak memberikan pengesahan dalam tempoh 2 jam, maka siaran itu mungkin telah tersiar (may_be_published).
  • reconnect: TikTok menolak token akaun, dan akaun itu perlu log masuk semula.
  • internal: easyCoexistence gagal sebelum menyerahkan siaran, jadi tiada apa-apa yang dihantar.

Bagaimana anda mencari dan mencuba semula siaran yang gagal?

Pemilik menerima e-mel untuk kegagalan yang dikesan di latar belakang, paling banyak satu bagi setiap saluran setiap 3 jam, dan URL peristiwa bagi platform menerima post.failed. Siaran itu muncul di bawah Perlu perhatian pada skrin Siaran, dengan Cuba semula, Sambung semula dan Abaikan, dan list_scheduled_posts memulangkannya kepada Claude atau ChatGPT. retry_scheduled_post menerbitkannya semula, sekarang, daripada fail yang disimpan selama 7 hari selepas kegagalan; apabila may_be_published bernilai true, semak list_social_posts dahulu dan hantar confirm hanya jika siaran itu tiada. Siaran yang memerlukan fail atau kapsyen baharu dijadualkan semula sebaliknya.

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 }

Kesilapan biasa

  • Mencuba semula kegagalan semakan dengan fail yang sama. TikTok menandakan kegagalan format, tempoh, kadar bingkai dan saiz gambar sebagai tidak boleh dicuba semula.
  • Mencuba semula spam_risk_too_many_posts serta-merta. TikTok mengira siaran API dalam tempoh 24 jam dan mencadangkan siaran dari aplikasi mudah alih.
  • Mencuba semula siaran yang ditandakan may_be_published tanpa menyemak. TikTok mungkin telah menyiarkannya; semak siaran terkini akaun, atau ia akan tersiar dua kali.
  • Mencari fail_reason pada API perniagaan TikTok. Endpoint statusnya menamakan medan itu reason; fail_reason tergolong dalam Content Posting API.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.

Soalan lazim

Apakah maksud picture_size_check_failed pada TikTok?

TikTok memuat turun siaran dan mendapati imejnya kurang daripada minimum 360 piksel tinggi dan lebar; ia memerlukan fail yang lebih besar, kerana TikTok menandakan kegagalan itu sebagai tidak boleh dicuba semula.

Apakah video_pull_failed?

TikTok tidak dapat memuat turun video daripada URL-nya, atau tidak dalam tempoh tamat masa satu jam. Semak sama ada URL itu awam dan tidak dihadkan lebar jalur, kemudian cuba semula.

Berapa lama spam_risk_too_many_posts berlangsung?

TikTok mengira siaran yang dibuat melalui API dalam tempoh 24 jam yang lalu, kira-kira 15 sehari bagi setiap akaun, dan mencadangkan siaran dari aplikasi mudah alih TikTok sementara itu.

Adakah easyCoexistence mencuba semula siaran TikTok yang gagal dengan sendirinya?

Tidak selepas TikTok melaporkan FAILED: siaran itu menunggu di bawah Perlu perhatian dan pemilik menerima e-mel, dan Cuba semula atau retry_scheduled_post menghantarnya semula.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada