开发者文档 / 开始使用
LINGTU AI OpenAPI v1.10.0
文档介绍
通过灵途 AI 开放接口,将达人分析、商品管理、内容发布、AI 图片与视频生成及公开内容数据接入你的应用和 AI Agent。
https://api.ailingtu.com
发布流程
01
授权达人
oauthRegion → url02
查询达人
id + creatorId03
选择商品
SHOP / SHOWCASE04
上传素材
presign → PUT → confirm05
创建发布任务
VIDEO / PHOTO
- 鉴权方式
- x-api-key: <YOUR_API_KEY>
- 密钥仅保存在服务端,不要暴露在浏览器代码、排期表或日志中。
- 成功判断
- HTTP 2xx && response.code === 0
- HTTP 非 2xx、响应不是合法 JSON 或业务 code 非 0,均应按失败处理。
机器可读接口规范
AI Agent、SDK 生成和契约校验应优先读取 OpenAPI 规范。
联调检查清单
- 区分商品查询 id 与发布 creatorId
- isNew=false 时跳过 PUT 和 confirm
- photoUri 传 tiktokShop.coverUri,coverFileId 放请求根节点
- 图文 businessIds 严格保持展示顺序
- 保存 postId 并确认最终发布状态
准备开始接入?
在灵途 AI 开发者中心创建或管理密钥。
最后更新 · 2026-09-29