TikTok 发布规则

本页汇总 TikTok 开放平台（Accounts API）对发布的全部硬性约束。本平台不做本地预检，以下均为官方控制、报错透传；提前知晓可避免无效重试。

配额（硬性）

账号的最大发布时长用 haina tt insight video-settings --account <账号> 查询（max_video_post_duration_sec，实测 3600s）。

URL 所有权验证（2023-11-16 起强制）

• 未验证域名的 video_url / photo_images 会被拒发。
• 本平台视频库返回的 URL 已完成验证，直接使用无风险。
• 自有 OSS/域名：需先在 TikTok 侧完成 URL 资源所有权验证（或联系管理员走 /business/property/list/ 确认）。
• 测试可用官方免验证视频 URL：https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4。

隐私档位

• 图片帖 privacy_level 必填；视频发布为公开帖（v1.3 无该参数）。
• 可用档位以账号为准：PUBLIC_TO_EVERYONE / MUTUAL_FOLLOW_FRIENDS / FOLLOWER_OF_CREATOR（私密账号）/ SELF_ONLY，用 haina tt insight video-settings --account <账号> 查询。
• disable_comment/duet/stitch 受账号设置约束（账号级禁用时只能传 true）。

草稿

• --draft（视频 upload_to_draft / 图片 is_draft）：进 TikTok App 收件箱，不直接发布；需坐席授权含 video.upload scope。
• 草稿终态 = publish_draft_inbox（SEND_TO_USER_INBOX 归一）。
• 草稿模式下 post_info 其他字段全部被官方忽略。

发布状态流转

submitted → publish_processing（含 PROCESSING_DOWNLOAD=URL 拉取中）
  → publish_complete（附 postId；postId 生成延迟约 3 分钟）
  → publish_failed（附官方 reason，如 frame_rate_check_failed）
  → publish_draft_inbox（草稿）

品牌与内容标记

• is_brand_organic（推广自己品牌）与 is_branded_content（付费合作）同传 true 时后者优先。
• is_ai_generated 标记后不可更改（不违反社区守则前提下不影响投放）。
• is_ads_only 发布为"仅广告展示"视频（不出现在主页，可经 insights ad_post_only 过滤查询）。

BGM：CML 商用音乐库（视频帖 / 图片帖）

• 选曲：GET /v1/tiktok/v1.3/discovery/cml/trending_list（CLI tt music trending）拿热门曲目；发布接口的 musicSoundId 要传响应里嵌套对象的 trendingSongClip.songClipId（近 30 天最热剪辑）或 fullDurationSongClip.songClipId（完整曲目，可为空对象 {}，空时用前者）——不是 commercialMusicId（曲目 id，仅 tt music trending-videos 查关联热门视频用）。曲目顶层 duration 对剪辑曲目可能为 0，真实时长看 clip 对象的 duration。
• 音量默认坑：官方 API 两个音量字段默认都是 0（静音），App 内默认是 50。本平台对齐 App：传了 musicSoundId 但未显式给音量时，自动补 musicSoundVolume=50 + videoOriginalSoundVolume=50；显式传 0 以你为准（真要静音就这么传）。要保留视频原声（口播人声）必须保证 videoOriginalSoundVolume > 0。
• 与 TikTok Shop 挂车 musicId 语义不同：TikTok Shop 电商授权音乐（tts music search 命令）是完全覆盖原声，不是混音；CML 是混音（音乐音量 + 原声音量两个滑杆）。两个库不通用，别混传。
• CML ≠ App 流行曲库：热门版权流行歌不对 Business 账号开放（App 内也一样）。要流行歌只能发草稿（--draft）后在 App 内手动加。
• 时间点：musicSoundStart / musicSoundEnd 毫秒；musicSoundEnd 缺省 = 视频时长（10s 音乐配 2s 视频只取前 2s）。
• 图片帖：--auto-add-music（自动配乐）与 --music-id（指定曲目）皆可。
• 音乐可用性/地区版权限制由官方校验，报错原样透传（3001）。
• 官方限流：Discovery API 全端点共享 10 QPS/开发者应用，选曲是低频操作，勿高频轮询。

发布后画质

官方转码可能降低分辨率/比特率（取决于播放设备与网络），属正常现象。

来源：TikTok 官方文档（Accounts API › Posts 章节）。