HAiNA CLI docs

限制与规则

大小/格式/有效期/一次性消耗/配额等硬约束

限制与规则

视频

项规则
格式mp4 / mov(Content-Type video/mp4 / video/quicktime;官方还支持 webm,本平台只收前两种)
大小≤ 100MB(超限 2001;官方上限 1GB,本平台收紧)
TikTok 视频官方规格时长 3–600 秒;宽高均 ≥360px;帧率 23–60 FPS(不满足会在发布阶段被官方拒)
TikTok 视频有效期videoUrl 上传后 7 天有效(平台计时);到期不可发布(2005),需重新上传
TikTok Shop 视频fileId 一次性消耗:发布调用即作废(失败也不可复用),重发需重新上传;无 URL 过期概念
发布频次TikTok 发布:官方限制每账号 ≤6 个/分钟、≤15 个/天(批量发布请自行控制节奏,超限会被官方拒绝);TikTok Shop 挂车:平台侧配额(不同账号不同),超限官方报错,发布成功响应可能带 quota 字段提示剩余配额
TikTok Shop 预审配额50 次/天/账号(API 渠道独立计数;同一 fileId 重复提交会多次消耗);耗尽返回 2002,次日恢复

API 限流

  • 限制:60 次/分钟/token(令牌桶)
  • 超限返回:HTTP 429 + code 2002 + Retry-After 响应头
  • 处置:按 Retry-After 等待后重试,退避至多 3 次

TikTok Shop 挂车内容规范(官方要求)

这些规则由官方在发布时校验(平台不预检,违规透传官方报错 3001,message 带官方原因):

  1. fileId 一次性消耗:发布调用即消耗,失败也不能复用。重发必须重新上传视频。 另外 fileId 与上传时的账号绑定(官方规则):A 账号上传的视频只能由 A 账号发布——发布时的 accountId 必须与上传时一致。
  2. 锚点文案(productTitle):必填,≤30 个字符,不能有标点和 emoji(车用脚垫 ✅、好货! ❌)。
  3. 商品必须可挂车:reviewStatus=APPROVED 且有货;商品需与视频内容相关。
  4. 预审可选但强烈建议(MRD IF-161144):发布接口不要求预审凭证(与官方一致);但官方规则要求违规内容不应发布——status=failed(violation FAIL)时请修正素材重审,是否发布由你自行判断并承担后果。优质检查(good quality)未过不阻断,仅给优化建议。预审配额 50 次/天/账号,耗尽返回 2002。

字段级补充(同为官方校验):

  • title(视频文案):支持 #话题 与 @提及(@提及 仅互关好友生效,App 内显示为纯文本)
  • isAiGenerated:AI 生成内容必须传 true(发布后会带 AI 标识)

套餐与坐席

  • 套餐到期 → 写操作(上传/发布)返回 1003,只读接口不受影响
  • 1 个 TikTok 账号 = 1 坐席;同账号 TikTok 发布 + TikTok Shop 挂车双能力只占 1 个坐席
  • 同账号不能跨坐席(1006);同坐席两能力必须同一账号(1008)

视频规格建议(TikTok Shop 官方)

  • 宽高比 9:16 ~ 16:9(推荐 9:16)
  • 分辨率 720p+
  • 时长建议 >30 秒

On this page