LINGTU AI OpenAPI
带货发布总览
带货发布只覆盖 TikTok Shop 带货视频与带货图文。两条流程共用授权、选品、排期、创建任务和发布记录;差异集中在素材与带货设置,因此拆成两个独立页面维护细节。
选择发布类型
公共发布路径
01
第 1 步 · 达人授权
获取 TikTok Shop 授权链接,查询可用达人。
- oauthRegion 决定市场和店铺类型
- 达人在浏览器打开 url 或扫码确认
- 查询账号传 authSource=TIKTOK_SHOP_CREATOR;图文再加 hasPhotoPermission=true
02
第 2 步 · 选品与排期
选择店铺或橱窗商品,设置发布日期。
- 查商品用账号 id,创建任务用 creatorId
- 橱窗缺商品时按商品 ID 或链接添加
- 设置时区、发布日期、每天条数,或立即发布
03
第 3 步 · 素材与设置
上传视频或图片,设置商品标题、音乐和可选封面。
- 视频:1 条文件,走 presign → PUT → confirm
- 图文:1~15 张图片按展示顺序,每张走预签名
- 商品标题必填;音乐来自搜索或灵途音乐收藏
04
第 4 步 · 校验与创建任务
校验后逐条调用 createPost。
- 带货视频预审选填、默认关闭
- 定时任务至少提前 5 分钟
- 校验标题、素材、商品和时间
05
发布后 · 发布记录
跟踪最终状态、平台作品 ID 和失败原因。
- 创建成功只表示任务已接收
- 对待发布任务立即发布,按需修改或取消
- 从发布记录确认平台最终状态
视频 / 图文差异
视频:1 条文件 + 可选预审
一个任务 1 条视频;预审选填且仅视频支持;封面可截帧或上传。
图文:1~15 张有序图片
图文需要图片权限,businessIds 按展示顺序,无封面、无预审。
创建成功 ≠ 发布成功
createPost 只表示任务已接收;预审结果、平台作品 ID 和失败原因以发布记录为准。
定时 / 立即发布
定时任务至少提前 5 分钟;立即发布把 scheduledAt 设为当前时间。
接入提示
- 带货发布只接受 TikTok Shop 授权达人;图文还需要图片权限。
- 授权链接必须在服务端生成,密钥不要下发到浏览器。
- 查商品用账号 id,创建任务用 creatorId。
- 发布前确认商品有库存,避免掉车。