一次发布到 TikTok / YouTube / Instagram / Threads / X / Pinterest / LinkedIn / Facebook。传 `scheduleAt`(带时区的 ISO 8601)则改为定时发布。
API Key 拥有完整权限(可发布、删除),写操作请在你自己的环境中执行。
ApiKeyAuth鉴权Bearer <lumi>Authorization: Bearer lumi_xxx。用户 API Key 拥有完整权限,自主运行的 agent 可以发布视频、取消任务。每个账号只有一把 Key,如需隔离请为 agent 使用单独的 LumiPath 账号。
application/json- 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"VIDEO""IMAGE""DOCUMENT"text*stringmediaUrls*array<>1 <= items <= 35vid?stringlocalProjectId?stringscheduleAt?string带时区的 ISO 8601 时间戳(例如 2026-07-11T10:00:00Z 或 +08:00),传了就改为在该时间定时发布(必须在 1 分钟到 365 天之后)。请求会立即完整校验,到点由后台任务执行;响应返回 scheduleJobId,而不是各账号的结果。
date-timetiktokConnectionIds?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- response
success*truetrueresults?scheduled?booleanscheduleJobId?stringscheduledAt?stringcurl -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"}定时发布的状态。传 `scheduleJobIds` 查询指定的几条,不传则列出所有待执行的。 POST
上一页
TikTok Ads MCP 访问令牌(权限范围 `mcp:tt4b`)。 GET
供 Lumi/agent 实例连接 TikTok 官方的 Ads MCP 服务。来自专门的 TikTok 广告授权入口(`POST`/`DELETE /api/link/tiktok/mcp`),该入口通过 DCR 注册公开 OAuth 客户端并走 PKCE 授权码流程。这个令牌只能用于 MCP 传输,用它调用 `https://business-api.tiktok.com/open_api/v1.3/...` 会返回 `code: 40105`,那种场景请用 `/api/v1/tiktok/marketing-token`。令牌过期或临近过期时由服务端刷新。从未授权 TikTok Ads MCP 时返回 404 `TIKTOK_MCP_NOT_CONNECTED`;保存的令牌已过期且无法刷新时返回 401 `TOKEN_EXPIRED`。