您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。

LINGTU AI OpenAPI

带货视频发布流程

本文只覆盖 TikTok Shop 带货视频。前置条件是达人已完成 TikTok Shop 授权;之后按「选择达人 → 选品与排期 → 上传视频与设置 → 校验并创建任务 → 发布记录」执行。

前置条件:先完成 达人授权流程

发布流程图

是否立即定时
前置:已完成授权
已通过 TikTok Shop 授权;authSource=TIKTOK_SHOP_CREATOR
选择达人
选择已授权达人作为发布账号;发布任务用 creatorId
选择商品
店铺商品 / 橱窗商品,按商品 ID 或链接选品
设置排期
发布时区、发布日期、每天条数,或立即发布
前端设置,无需接口
上传视频
1 条视频;presign → PUT → confirm
带货设置
商品标题、音乐、封面(截帧或上传)、AI 标识
第 5 步:校验
预审选填(仅视频);标题、素材、商品、时间(≥5 分钟)
前端校验,无需接口
创建发布任务
立即:scheduledAt=当前时间;定时:排期时间 + scheduledTz
发布记录
状态、平台作品 ID、失败原因;待发布可 submit / update / cancel
秒传复用文件
复用返回的 fileId,跳过 PUT 和 confirm
预签名 isNew?定时发布?
TikTok Shop 带货视频发布流程图:选择已授权达人、选品与排期、上传素材、带货设置、校验、创建发布任务与发布记录。

每一步做什么

01

第 1 步 · 选择达人

选择用于发布的已授权达人账号。

  • 只选择已授权带货达人;查询账号传 authSource=TIKTOK_SHOP_CREATOR
  • 带货视频:permissions 同时包含 LIVE_STREAM_PERMISSION 和 SELF_SALE_PERMISSION 时,一定具备带货视频权限
  • 创建发布任务用 creatorId,查询商品用账号 id
02

第 2 步 · 选品与排期

选择店铺或橱窗商品,设置发布日期。

  • 商品来自店铺或橱窗;橱窗缺商品时可按商品 ID 或链接添加
  • 设置发布时区、发布日期、每天条数,或选择立即发布
  • 发布前确认商品有库存,否则平台可能丢弃商品锚点(掉车)
03

第 3 步 · 上传视频

每个任务上传 1 条视频,走预签名直传。

  • 先计算文件 Hash,再用 fileName、contentType、size、hash 调预签名接口
  • isNew=true 时 PUT 到 uploadUrl,然后调用 confirm
  • isNew=false 时直接复用返回的 fileId,跳过 PUT 和 confirm
  • businessId 传视频 fileId 的字符串形式,businessType=FILE
04

第 4 步 · 带货设置

设置每个任务的商品标题、音乐、封面和 AI 生成标识。

  • 商品标题必填、可修改;发布前校验禁用字符和长度
  • 音乐可搜索或复用灵途音乐收藏,发布以 musicId 为准
  • 封面可用视频截帧时间点,或上传自定义封面后把 photoFile.photoUri 传给 tiktokShop.coverUri
  • 上传自定义封面时把 coverFileId 放请求根节点,并省略 coverTimestampMs
  • 需要时标记为 AI 生成内容
05

第 5 步 · 校验并创建任务

可选开启视频预审,校验后创建发布任务。

  • 预审选填、默认关闭;开启后设置超时,官方预审未完成时自动跳过并继续发布
  • 定时任务至少提前 5 分钟;立即发布取当前时间
  • 校验标题、视频 fileId、商品和排期
  • 调用 createPost,传 scheduledAt、scheduledTz 和 tiktokShop 参数
06

发布后 · 记录与跟进

跟踪预审结果、平台作品 ID 和失败原因。

  • 创建成功只表示任务已接收
  • 查询发布记录与任务详情获取最终状态
  • 对待发布任务立即发布,修改仍可变更的任务,或取消任务
  • 保存 postId 便于后续跟进

关键分支

定时 / 立即发布

定时任务至少提前 5 分钟;立即发布把 scheduledAt 设为当前时间。

新视频 / 秒传

预签名返回 isNew;只有新文件需要 PUT 和 confirm。

预审是选填

预审只作用于带货视频;开启后设置超时,超时未完成自动跳过并继续发布。

封面:截帧或上传

既可以用 coverTimestampMs 截帧,也可以上传封面后传 coverUri + coverFileId,两者互斥。

创建成功 ≠ 发布成功

createPost 只表示任务已接收;最终平台状态以发布记录为准。

接入提示

  • 发布前达人必须已完成 TikTok Shop 授权,见「达人授权流程」。
  • 商品标题会校验长度和禁用字符,创建任务前先修正。
  • 自定义封面上传时要 returnCoverFileId=true,发布时同时传 photoUri 与 coverFileId。
  • scheduledAt 是绝对时间戳,scheduledTz 是目标市场的 IANA 时区。
  • isNew=false 表示视频已存在,直接复用 fileId,不要重复上传。