LINGTU AI OpenAPI
带货视频发布流程
本文只覆盖 TikTok Shop 带货视频。前置条件是达人已完成 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,不要重复上传。