Cara menyiarkan video ke TikTok melalui API
Untuk menyiarkan video melalui API for Business TikTok, hantar POST /business/video/publish/ dengan business_id akaun, video_url pada domain atau awalan URL yang disahkan, dan objek post_info yang memuatkan kapsyen dan tetapan, bersama header Access-Token. TikTok membalas dengan share_id; hantarkannya sebagai publish_id kepada /business/publish/status/ sehingga status menunjukkan PUBLISH_COMPLETE dan post_ids muncul.
easyCoexistence menyiarkan video TikTok dengan publish_tiktok_post daripada Claude, ChatGPT atau ejen anda sendiri: hantar pautan HTTPS, kapsyen dan sama ada komen dihidupkan, kemudian jejaki siaran dengan get_tiktok_publish_status, manakala fail sampai ke TikTok melalui laluan media sahnya.
Dikembalikan oleh panggilan penerbitan, contohnya v_pub_url~v1.2345123456789123456, dan dihantar kepada panggilan status sebagai publish_id.
Sejak itu, TikTok menolak untuk menerbitkan video daripada URL yang domain atau awalan URL-nya tidak disahkan.
Had TikTok bagi siaran video setiap akaun melalui endpoint penerbitan, dengan paling banyak 15 sehari.
Tempoh masa post_ids boleh mengambil masa untuk muncul selepas PUBLISH_COMPLETE; TikTok menyarankan cuba semula selepas tiga minit.
Dihantar dalam webhook post.publish.publicly_available apabila siaran lulus moderasi, sedia untuk membuat pertanyaan terhadap insight-nya.
Apakah yang anda perlukan sebelum panggilan pertama?
Tiga perkara. Token akses TikTok bagi akaun dan open_id akaun, daripada pertukaran token; aplikasi pembangun yang memegang kebenaran Video Publish di bawah TikTok Accounts; dan video pada URL HTTPS atau HTTP awam yang berada di bawah domain atau awalan URL yang disahkan untuk aplikasi. TikTok memuat turun fail itu sendiri, jadi ia mesti kekal boleh dicapai, dan TikTok mengesyorkan URL yang bertahan sekurang-kurangnya 30 minit.
Bagaimana rupa permintaan penerbitan?
Satu POST ke https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ dengan token akaun dalam header Access-Token dan Content-Type ditetapkan kepada application/json. Badan JSON menamakan akaun dalam business_id, fail dalam video_url dan tetapan siaran dalam post_info; contoh ini menerbitkan video berkapsyen dengan komen, Duet dan Stitch kekal dihidupkan:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {
"caption": "Our new menu is live #food",
"is_brand_organic": false,
"is_branded_content": false,
"disable_comment": false,
"disable_duet": false,
"disable_stitch": false
}
}'Apakah fungsi setiap medan dalam badan JSON?
Medan yang disenaraikan dalam rujukan TikTok untuk siaran video, bermula dari aras teratas. Penutup, label dijana AI, lokasi, draf dan pilihan hanya-iklan terletak dalam badan yang sama:
business_id:open_idakaun daripada pertukaran token.video_url: fail yang dimuat turun TikTok, MP4, MOV atau WebM, pada domain atau awalan URL yang disahkan.post_info: wajib pada setiap panggilan, walaupun sebagai objek kosong, dan menempatkan tetapan siaran.post_info.caption: sehingga 2,200 aksara dikira dalam UTF-16, dengan #hashtag dan sehingga 30 @mention.post_info.is_brand_organicdanis_branded_content: label Promotional content dan Paid partnership, yang ditanda sebagai wajib dalam jadual TikTok.post_info.disable_comment,disable_duetdandisable_stitch: true mematikan komen, Duet atau Stitch; ketiga-tiganya lalai kepada false.
Apakah yang TikTok kembalikan?
Bentuk respons biasa, dengan ID tugas penerbitan dalam data. Kod 0 bermakna TikTok menerima tugas, bukan bahawa video sudah disiarkan: TikTok masih perlu memuat turun fail, menyemaknya dan memoderasi siaran. Dalam contoh TikTok, share_id video bermula dengan v_pub_url dan share_id siaran foto dengan p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}Bagaimana anda menjejaki siaran sehingga ia disiarkan?
Dengan GET /business/publish/status/, menghantar business_id dan share_id sebagai publish_id. status menunjukkan PROCESSING_DOWNLOAD semasa TikTok mengambil fail, PUBLISH_COMPLETE apabila siaran lulus moderasi, atau FAILED dengan sebab. post_ids tiba bersama PUBLISH_COMPLETE apabila siaran boleh dilihat secara awam, dan boleh lewat sehingga tiga minit. Keseluruhan aliran dalam Python:
import os, time, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"] # open_id from the token exchange
def call(method, path, **kwargs):
body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
if body.get("code") != 0: # errors arrive in code, usually with HTTP 200
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
return body["data"]
share_id = call("POST", "business/video/publish/", json={
"business_id": BUSINESS_ID,
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {"caption": "Our new menu is live #food",
"is_brand_organic": False, "is_branded_content": False},
})["share_id"]
for _ in range(30):
time.sleep(60) # each check is a call; TikTok's stages take minutes
s = call("GET", "business/publish/status/",
params={"business_id": BUSINESS_ID, "publish_id": share_id})
if s["status"] == "FAILED":
raise RuntimeError(s.get("reason"))
if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
print("Live:", s["post_ids"])
breakBolehkah webhook menggantikan semakan status?
Boleh, bagi aplikasi yang melanggan event_type VIDEO dengan /business/webhook/update/. TikTok kemudian menghantar post.publish.failed atau post.publish.complete setelah ia memuat turun dan menyemak fail, post.publish.publicly_available dengan post_id baharu apabila moderasi lulus, dan post.publish.no_longer_publicly_available jika siaran kemudian tidak lagi dilihat secara awam. Setiap event menamakan tugas dalam publish_id, nilai yang sama dengan share_id.
Bagaimana anda menyiarkan video melalui MCP?
Minta dalam bahasa biasa daripada Claude, ChatGPT atau klien lain yang disambungkan ke https://easycoexistence.com/api/mcp. Pembantu memanggil publish_tiktok_post dengan account_id daripada list_social_accounts, video_url HTTPS, kapsyen dan, jika anda mahu komen dimatikan, disable_comment. Hasilnya membawa share_id TikTok, dan get_tiktok_publish_status, diberi account_id dan share_id itu, mengembalikan status, post_ids dan reason TikTok seadanya.
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"caption": "Our new menu is live #food",
"disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
"note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }Apakah yang publish_tiktok_post hantar kepada TikTok?
Panggilan ke endpoint yang sama, diisi daripada permintaan anda. Pautan anda dihantar kepada TikTok sebagai pautan bertandatangan di bawah laluan media sah easyCoexistence sendiri, jadi ia tidak memerlukan pengesahan sendiri; kapsyen dan disable_comment dihantar seperti yang anda beri; dan is_brand_organic serta is_branded_content dihantar sebagai false. Tetapan lain, seperti Duet, Stitch, penutup dan label dijana AI, kekal dengan lalai TikTok, dan video diterbitkan sebagai siaran awam, sebagaimana endpoint direka untuk berbuat demikian.
Apakah yang boleh anda lakukan dengan kelayakan daripada Partner API?
Panggil TikTok secara langsung sebagai akaun. GET /channels/{id}?credentials=1 pada https://easycoexistence.com/api/v1, dengan kunci ec_live_ anda sebagai bearer token, mengembalikan saluran dengan objek credentials: api_base, business_id, access_token semasa dan token_expires_at. Semakan status, senarai video, komen dan insight kemudiannya dijalankan daripada kod anda sendiri. Penerbitan ialah bahagian yang perlu dirancang: panggilan penerbitan terus menghantar video_url kepada TikTok tanpa diubah, sifat URL ditambah dengan ID dan rahsia aplikasi pembangun sendiri, dan awalan yang disahkan oleh aplikasi easyCoexistence ialah laluan media, yang digunakan oleh publish_tiktok_post.
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# "credentials": {
# "platform": "tiktok",
# "api_base": "https://business-api.tiktok.com/open_api/v1.3",
# "business_id": "<OPEN_ID>",
# "access_token": "<ACCESS_TOKEN>",
# "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'publish_id=<SHARE_ID>'Cara menetapkannya
- Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
- Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
- Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.
Kesilapan biasa
- Tertinggal post_info. TikTok memerlukan objek ini pada setiap panggilan, walaupun tiada tetapan berubah.
- Mencari ID siaran dalam respons penerbitan. Ia hanya mengembalikan share_id; ID siaran datang daripada panggilan status atau webhook publicly_available.
- Mengulang panggilan penerbitan yang tamat masa. Permintaan pertama mungkin telah sampai ke TikTok, jadi semak siaran terkini akaun sebelum menghantarnya semula.
- Menganggap kod 0 sebagai video yang sudah disiarkan. Ia bermakna TikTok menerima tugas, dan fail itu masih boleh gagal semakan selepas dimuat turun.
US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan percubaan percuma 3 hari.
Soalan lazim
Endpoint manakah menyiarkan video ke TikTok?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, dengan token akaun dalam header Access-Token dan business_id, video_url serta post_info dalam badan JSON.
Bolehkah TikTok API memuat naik fail video secara langsung?
Tidak melalui /business/video/publish/. Ia mengambil video_url dan memuat turun fail daripadanya, jadi video memerlukan URL pada domain atau awalan URL yang disahkan.
Bagaimana anda mendapat ID video yang disiarkan melalui API?
Daripada post_ids dalam /business/publish/status/ apabila status PUBLISH_COMPLETE dan siaran awam, atau daripada post_id dalam webhook post.publish.publicly_available.
Bolehkah saya menjadualkan video TikTok untuk kemudian melalui API?
Endpoint penerbitan menyiarkan apabila ia dipanggil dan tiada medan masa. easyCoexistence menyimpan siaran berjadual dalam baris gilirannya sendiri dan memanggil TikTok pada masa yang anda tetapkan.
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