Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Tetapan hantaran TikTok melalui API: privasi, komen, duet dan stitch

Panggilan penerbitan API TikTok for Business menerima tetapan hantaran, kebanyakannya di dalam post_info. Video menerima disable_comment, disable_duet dan disable_stitch, sampul daripada thumbnail_offset atau custom_thumbnail_url, label is_brand_organic dan is_branded_content, serta is_ai_generated. Hantaran foto menerima privacy_level, disable_comment, label jenama yang sama dan auto_add_music. GET /business/video/settings/ memulangkan nilai yang dibenarkan bagi setiap akaun.

easyCoexistence menerbitkan video dan hantaran foto TikTok dengan publish_tiktok_post daripada Claude, ChatGPT atau kod anda sendiri, dengan kapsyen, tajuk hantaran foto, dan komen dihidupkan atau dimatikan, dan get_social_credentials memberikan kod anda sendiri token untuk membaca tetapan yang dibenarkan bagi akaun.

3 levels

Pilihan privasi bagi hantaran foto akaun awam: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS dan SELF_ONLY.

FOLLOWER_OF_CREATOR

Tahap privasi yang diberikan kepada akaun persendirian sebagai ganti PUBLIC_TO_EVERYONE: boleh dilihat oleh pengikutnya sahaja.

false

Nilai lalai bagi disable_comment, disable_duet dan disable_stitch, jadi komen, Duet dan Stitch kekal dibenarkan melainkan ditetapkan.

1080 x 1920

Had maksimum imej sampul tersuai bagi video: sekurang-kurangnya 360 x 360 piksel dan sehingga 20 MB.

Paid partnership

Label is_branded_content dikenakan; ia diutamakan apabila is_brand_organic juga bernilai true.

privacy_level

Medan wajib post_info bagi hantaran foto, terhad kepada pilihan yang dipulangkan oleh GET /business/video/settings/ bagi akaun tersebut.

Apakah tetapan yang diterima oleh setiap endpoint penerbitan?

/business/video/publish/ dan /business/photo/publish/ berkongsi sebahagian tetapan dan berbeza pada yang lain. Kebanyakannya berada dalam post_info, manakala custom_thumbnail_url dan photo_cover_index berada pada peringkat atas badan permintaan. Disusun sebelah-menyebelah, seperti yang disenaraikan dalam rujukan TikTok, dengan Tiada medan bagi endpoint yang tidak mendokumentasikan tetapan tersebut:

Video postPhoto post
Who sees itNo privacy field: the endpoint publishes public video postsprivacy_level, required
Commentsdisable_commentdisable_comment
Duet and Stitchdisable_duet, disable_stitchNo field
Covercustom_thumbnail_url or thumbnail_offsetphoto_cover_index
Brand labelsis_brand_organic, is_branded_contentis_brand_organic, is_branded_content
AI labelis_ai_generatedNo field
Musicmusic_sound_info, video_original_sound_volumeauto_add_music, music_sound_info
Locationlocation_id with location_namelocation_id with location_name
Draftupload_to_draftis_draft

Apa yang dibenarkan oleh akaun?

GET /business/video/settings/ dengan business_id memulangkan had akaun ke atas hantarannya. Baca dahulu sebelum menerbitkan, kerana TikTok hanya menerima nilai yang disenaraikannya:

  • privacy_level_options: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS dan SELF_ONLY bagi akaun awam; FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS dan SELF_ONLY bagi akaun persendirian.
  • comment_disabled: true apabila akaun tidak menerima komen daripada sesiapa, dan ketika itu disable_comment hanya menerima true.
  • duet_disabled dan stitch_disabled: true apabila akaun hanya membenarkan Duet atau Stitch untuk Only you, atau akaun itu persendirian; suis yang sepadan kemudian hanya menerima true.
  • max_video_post_duration_sec: video terpanjang yang boleh diterbitkan oleh akaun; video yang lebih panjang akan gagal.
Read an account's post settings
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "comment_disabled": false,
    "duet_disabled": false,
    "max_video_post_duration_sec": 600,
    "privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
    "stitch_disabled": false
  }
}

Siapa yang boleh melihat hantaran?

Pada hantaran foto, privacy_level yang anda hantar: PUBLIC_TO_EVERYONE untuk orang di dalam atau di luar TikTok, MUTUAL_FOLLOW_FRIENDS untuk pengikut yang turut diikuti semula oleh akaun, FOLLOWER_OF_CREATOR untuk pengikut akaun persendirian, atau SELF_ONLY. Endpoint video tidak mempunyai medan privasi, kerana ia menerbitkan hantaran video awam. Hantaran yang ditetapkan kepada Friends atau Only you juga tidak boleh ditonton melalui embed_url-nya.

Bagaimana komen, Duet dan Stitch berfungsi?

Setiap satu ialah suis yang mematikan ciri apabila ditetapkan kepada true. disable_comment terdapat pada kedua-dua endpoint; disable_duet dan disable_stitch hanya terdapat pada video. Semuanya lalai kepada false, yang membiarkan ciri itu aktif dalam had tetapan privasi akaun itu sendiri: akaun yang tidak menerima komen daripada sesiapa, atau yang mengehadkan Duet atau Stitch kepada Only you, hanya boleh menerbitkan dengan suis itu ditetapkan kepada true.

Bagaimana sampul dipilih?

Pada video, ada dua cara. post_info.thumbnail_offset memilih bingkai mengikut masanya dalam milisaat, lalai 0, dibundarkan ke atas kepada bingkai terdekat; masa yang melepasi penghujung video menghantar webhook kegagalan dan video tidak diterbitkan. custom_thumbnail_url, pada peringkat atas badan permintaan, memberikan imej sebaliknya dan menjadikan TikTok mengabaikan offset. Pada hantaran foto, photo_cover_index memilih salah satu imej, dikira dari 0.

  • Imej sampul tersuai: JPG, JPEG, WebP atau PNG, sehingga 20 MB.
  • Saiz: dari 360 x 360 piksel hingga 1080 x 1920, atau 1920 x 1080.
  • Lokasi: domain atau awalan URL yang disahkan untuk aplikasi, sama seperti video itu sendiri.

Apa maksud label jenama?

Pendedahan yang dipaparkan TikTok pada hantaran. is_brand_organic yang ditetapkan kepada true melabelkannya sebagai Promotional content, bagi hantaran yang mempromosikan perniagaan akaun itu sendiri. is_branded_content yang ditetapkan kepada true melabelkannya sebagai Paid partnership, bagi hantaran yang dibuat dalam kerjasama berbayar dengan jenama, dan diutamakan apabila kedua-duanya true. Pada video dengan is_branded_content, tto_invite_link boleh memautkan hantaran kepada kempen TikTok One Creator Marketplace yang disertai oleh akaun itu.

Apakah pilihan lain dalam post_info?

Beberapa lagi, setiap satu didokumentasikan pada endpoint yang menerimanya:

  • is_ai_generated, video: melabelkan hantaran sebagai Creator labeled as AI-generated, yang tidak boleh diubah selepas disiarkan.
  • location_id bersama location_name: tag lokasi yang diperoleh melalui GET /business/publish/location/.
  • music_sound_info: bunyi komersial mengikut ID; pada video juga kelantangannya, 0 hingga 100, serta permulaan dan penamatnya dalam milisaat.
  • auto_add_music, hantaran foto: menambah muzik yang disyorkan, yang boleh diubah kemudian dalam aplikasi TikTok.
  • upload_to_draft atau is_draft: menghantar hantaran ke peti masuk pencipta sebagai draf, bersama video, dengan skop video.upload.
  • is_ads_only, video: menerbitkan hantaran Only show in ads yang kekal tidak dipaparkan pada profil.

Apakah tetapan yang ditetapkan oleh publish_tiktok_post?

Tiga datang daripada permintaan anda: kapsyen, tajuk hantaran foto, dan disable_comment. easyCoexistence menghantar is_brand_organic dan is_branded_content sebagai false, menerbitkan hantaran foto sebagai PUBLIC_TO_EVERYONE dengan imej pertama sebagai sampul, dan tidak memasukkan selebihnya tetapan video, supaya nilai lalai TikTok digunakan: disable_duet dan disable_stitch false, thumbnail_offset 0 dan is_ai_generated false.

Bagaimana anda menghantar tetapan lain?

Daripada kod anda sendiri, dengan token dan business_id akaun daripada get_social_credentials, pada laluan Business API di bawah business/. GET kepada business/video/settings/ membaca had akaun. POST kepada business/video/publish/ atau business/photo/publish/ boleh membawa badan lengkap yang didokumentasikan, dan ia sampai ke TikTok seperti yang ditulis, termasuk URL media, jadi URL itu mesti berada pada domain atau awalan URL yang disahkan untuk aplikasi; publish_tiktok_post ialah panggilan yang menghala pautan anda melalui laluan media yang disahkan oleh easyCoexistence.

Reading the settings from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>

Kesilapan biasa

  • Menjangka privacy_level berfungsi pada video. Endpoint video menerbitkan hantaran awam dan rujukannya tidak menyenaraikan medan privasi; hantaran foto menerima privacy_level.
  • Menghidupkan komen bagi akaun yang tidak menerima komen langsung. Apabila comment_disabled ialah true, TikTok hanya menerima disable_comment sebagai true.
  • Menetapkan thumbnail_offset melepasi penghujung video. TikTok menghantar webhook kegagalan dan video tidak diterbitkan.
  • Menghantar PUBLIC_TO_EVERYONE bagi akaun persendirian. privacy_level_options-nya menyenaraikan FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS dan SELF_ONLY sebagai gantinya.
Menggunakan EasyCoexistence untuk ini

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

Soalan lazim

Bolehkah saya menyiarkan video TikTok persendirian melalui API?

Tidak dengan endpoint video, yang menerbitkan hantaran awam. Hantaran foto menerima privacy_level, termasuk SELF_ONLY, dan video boleh dihantar ke peti masuk pencipta sebagai draf dengan upload_to_draft.

Bagaimana saya mematikan Duet dan Stitch melalui API?

Tetapkan post_info.disable_duet dan post_info.disable_stitch kepada true pada /business/video/publish/. Apabila akaun sudah mengehadkannya, TikTok hanya menerima true.

Bolehkah saya menambah tag lokasi melalui API TikTok?

Boleh. post_info menerima location_id bersama location_name, bagi tag lokasi yang diperoleh melalui GET /business/publish/location/.

Apakah perbezaan antara is_brand_organic dan is_branded_content?

is_brand_organic menambah label Promotional content bagi perniagaan akaun itu sendiri; is_branded_content menambah label Paid partnership dan diutamakan apabila kedua-duanya true.

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