TikTok API 草稿上传
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/acedatacloud-skills-tiktok。
技能介绍
要解决什么问题
不少自动化脚本只会看 TikTok 接口的 HTTP 状态码,却忽略响应体里的 error.code。诸如 spam_risk_too_many_posts、reached_active_user_cap 等失败常常仍是 HTTP 200,若不逐项检查就会把上传当成成功。另一方面,Content Posting 审计未通过时,Direct Post 看起来有 video.publish 范围却一律失败;能走通的路径是把视频送进创作者 草稿箱 / 收件箱,由人在 App 里补文案与隐私后再发。
技能如何工作
技能约定基址 https://open.tiktokapis.com/v2,每次请求带 Authorization: Bearer $TIKTOK_TOKEN,并用 curl + jq 解析 data / error 包装。读取粉丝数、简介、视频列表依赖 Display API 的 user.info.stats、user.info.profile、video.list——当前应用未授权这些 scope 时,不要调用 /v2/video/list/。
草稿上传的固定顺序:先把视频落到本地且暂不直传;用 request_action_confirmation(kind: generic)展示真实预览并说明「进草稿而非直接发布」;用户取消则停止;确认后只执行一次 python3 skills/tiktok/scripts/tiktok.py upload video.mp4,再用 status PUBLISH_ID 轮询到终态,轮询期间不得重复 upload。
上传源优先 FILE_UPLOAD:先下载再按字节长度 init,64 MB 以下单块上传;upload_url 约 1 小时过期,整文件成功常见 201。PULL_FROM_URL 仅对已验证域名有效,未验证会得 url_ownership_unverified。状态上 PROCESSING_* 之后 SEND_TO_USER_INBOX 即本流程成功,告知用户在 TikTok App 内完成发布;勿等待 PUBLISH_COMPLETE。
边界与注意点
- 勿调用
/v2/post/publish/video/init/做 Direct Post,直到通过 Content Posting API 审计。 auth_removed、spam_risk*等为终态错误,勿重试;internal可重试。- 速率:
video/init/约 6/min,创作者单日发帖约 15 条且跨应用共享。 - 将来若启用 Direct Post,禁止写死
privacy_level,须用privacy_level_options返回值。
使用场景
- Agent 拿到用户确认后,要把本地 mp4 上传到 TikTok 草稿箱并轮询到 SEND_TO_USER_INBOX
- 脚本调用 init 上传失败返回 HTTP 200,需要按 error.code 判断 spam_risk 并停止重试
- 从外链拉片未过开发者域名验证,需改用 FILE_UPLOAD 先下载再按文件大小分块上传
- OAuth 令牌失效出现 access_token_invalid,需要提示用户重新连接 TikTok 后再调 API
适合人员
- 维护 TikTok 开放平台集成、要把成片送进创作者草稿而非直发的后端工程师
- 编写 Agent 工作流、需在 upload 前做人机确认并严格执行单次上传+轮询的自动化作者
- 用 curl/jq 排查 TikTok v2 响应包装与 scope_not_authorized 的集成调试人员
- 负责 Content Posting 审计进度、需区分 Direct Post 不可用与草稿路径的运营技术对接人