跳到正文
LumiPath API
接口参考发布

一次发布到 TikTok / YouTube / Instagram / Threads / X / Pinterest / LinkedIn / Facebook。传 `scheduleAt`(带时区的 ISO 8601)则改为定时发布。

post/api/v1/social-posts

API Key 拥有完整权限(可发布、删除),写操作请在你自己的环境中执行。

鉴权

ApiKeyAuth
header鉴权Bearer <lumi>

Authorization: Bearer lumi_xxx。用户 API Key 拥有完整权限,自主运行的 agent 可以发布视频、取消任务。每个账号只有一把 Key,如需隔离请为 agent 使用单独的 LumiPath 账号。

请求体

application/json
  1. body

发布视频(contentType:VIDEO)或图文(contentType:IMAGE)。VIDEO 支持 TikTok、YouTube、Instagram、Threads、X、Pinterest、LinkedIn 和 Facebook。IMAGE 支持 Instagram、Threads、TikTok、X、Pinterest、LinkedIn 和 Facebook,单图还是轮播由 mediaUrls 数量决定(X≤4、Instagram≤10、Threads≤20、TikTok≤35、Pinterest≤1、LinkedIn≤20、Facebook≤10)。LinkedIn 发布到已连接的公司主页。Facebook 发布到已连接的主页(动态视频 / 图片帖)。YOUTUBE 只支持 VIDEO:contentType:IMAGE 加 YOUTUBE 返回 400。DOCUMENT 是仅限 LinkedIn 的 PDF 文档(轮播)帖:platforms 必须恰好是 ["LINKEDIN"],mediaUrls 必须恰好一个 PDF 地址(≤100 MB、≤300 页、白名单域名),并且必须提供 advanceConfig.linkedin.documentTitle。文档在后台上传(status:"processing")。

platforms*array<>
contentType*string
Value in"VIDEO""IMAGE""DOCUMENT"
text*string
mediaUrls*array<>
数组元素1 <= items <= 35
vid?string
localProjectId?string
scheduleAt?string

带时区的 ISO 8601 时间戳(例如 2026-07-11T10:00:00Z 或 +08:00),传了就改为在该时间定时发布(必须在 1 分钟到 365 天之后)。请求会立即完整校验,到点由后台任务执行;响应返回 scheduleJobId,而不是各账号的结果。

格式date-time
tiktokConnectionIds?array<string>
tiktokAccountNames?array<string>
tiktokConfigs?array<>
youtubeConnectionIds?array<string>
youtubeAccountNames?array<string>
youtubeConfigs?array<>
instagramConnectionIds?array<string>
instagramAccountNames?array<string>
threadsConnectionIds?array<string>
threadsAccountNames?array<string>
xConnectionIds?array<string>
xAccountNames?array<string>
xConfigs?array<>
pinterestConnectionIds?array<string>
pinterestConfigs?array<>
linkedinConnectionIds?array<string>
linkedinAccountNames?array<string>
linkedinConfigs?array<>
facebookConnectionIds?array<string>
facebookAccountNames?array<string>
advanceConfig?

按平台分组的高级发布设置,字段与平台官方接口一致。每个对象只接受该平台的官方字段白名单(未知字段会被拒绝),并作用于该平台下所有目标账号。

响应体

立即发布 → 返回各账号的 results(不是 {success,data} 包装)。定时发布(设置了 scheduleAt)→ { success, scheduled: true, scheduleJobId, scheduledAt }。

application/json
  1. response
success*true
Value intrue
results?
scheduled?boolean
scheduleJobId?string
scheduledAt?string
请求示例
curl -X POST 'https://app.lumipath.cn/api/v1/social-posts' \  -H 'Content-Type: application/json' \  -d '{  "platforms": [    "TIKTOK"  ],  "contentType": "VIDEO",  "text": "string",  "mediaUrls": [    "http://example.com"  ]}'
响应示例
{  "success": true,  "results": {    "TIKTOK": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ],    "YOUTUBE": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ],    "INSTAGRAM": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ],    "THREADS": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ],    "X": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ],    "PINTEREST": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ],    "LINKEDIN": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ],    "FACEBOOK": [      {        "connectionId": "string",        "status": "success",        "publishId": "string",        "mediaId": "string",        "info": "string",        "error": "string",        "errorCode": "string"      }    ]  },  "scheduled": true,  "scheduleJobId": "string",  "scheduledAt": "string"}