LINGTU AI OpenAPI
带货图文发布流程
本文只覆盖 TikTok Shop 带货图文。前置条件是达人已完成 TikTok Shop 授权并具备图片发布权限;之后按「选择达人 → 选品与排期 → 上传图片与设置 → 校验并创建任务 → 发布记录」执行。图文没有预审。
前置条件:先完成 达人授权流程
发布流程图
每一步做什么
01
第 1 步 · 选择达人
选择具备图片发布权限的已授权达人账号。
- 查询账号时传 hasPhotoPermission=true,并确认 permissions 包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP;两者都没有则没有带货图文权限
- 创建发布任务用 creatorId,查询商品用账号 id
02
第 2 步 · 选品与排期
选择店铺或橱窗商品,设置发布日期。
- 商品来自店铺或橱窗;橱窗缺商品时可按商品 ID 或链接添加
- 设置发布时区、发布日期、每天条数,或选择立即发布
- 发布前确认商品有库存,否则平台可能丢弃商品锚点(掉车)
03
第 3 步 · 上传图片
按展示顺序上传 1~15 张图片,走预签名直传。
- 每张图片分别走预签名;isNew=true 时 PUT,然后 confirm
- 保持上传顺序,它就是最终展示顺序
- 一个任务支持 1~15 张图片
- createPost 的 businessIds 用字符串文件 ID,按展示顺序排列
04
第 4 步 · 带货设置
设置每个图文任务的商品标题、音乐和 AI 生成标识。
- 商品标题必填、可修改;发布前校验禁用字符和长度
- 音乐可搜索或复用灵途音乐收藏,发布以 musicId 为准
- 图文没有封面设置,也没有视频预审
- 需要时标记为 AI 生成内容
05
第 5 步 · 校验并创建任务
校验图片、商品与排期后创建发布任务。
- 校验 1~15 张图片、商品、标题和排期时间(至少提前 5 分钟)
- 图文完全跳过预审
- 调用 createPost,mediaType=PHOTO,tiktokShopPhoto.postType=MULTI_PHOTO_ONE_ANCHOR
- businessIds 与 productLinks 分别描述图片和商品锚点
06
发布后 · 记录与跟进
跟踪平台作品 ID 和失败原因。
- 创建成功只表示任务已接收
- 查询发布记录与任务详情获取最终状态
- 对待发布任务立即发布,修改仍可变更的任务,或取消任务
- 保存 postId 便于后续跟进
关键分支
必须有图片权限
permissions 必须包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP;两者都没有则没有带货图文权限。
1~15 张图片,顺序重要
businessIds 按展示顺序排列;要调整顺序应在创建任务前完成,发布后无法改。
没有预审
带货图文没有预审;校验发生在 createPost 之前,平台失败原因在发布记录中查看。
定时 / 立即发布
定时任务至少提前 5 分钟;立即发布把 scheduledAt 设为当前时间。
创建成功 ≠ 发布成功
createPost 只表示任务已接收;最终平台状态以发布记录为准。
接入提示
- 授权成功不等于能发图文:带货图文还需要图片发布权限。
- 图片顺序要稳定;businessIds 就是展示顺序,发布后不能再调整。
- businessIds 传字符串文件 ID,不要传数字。
- scheduledAt 是绝对时间戳,scheduledTz 是目标市场的 IANA 时区。
- isNew=false 表示图片已存在,直接复用 fileId,不要重复上传。