跳到正文
LumiPath API

自动化

按计划搬运并本地化视频的策略、策略产生的任务,以及 AI 生成的策略草稿。

自动化把一个来源(抖音、小红书或 B 站的创作者)变成一串本地化后的视频,按计划发布到你的某个账号连接。

  • 策略(strategy):监控这个来源,按这种方式处理每条新视频,在这些时间发布到这个账号。
  • 策略抓到的每条视频会变成一个任务(task),依次经过处理、(可选的)审核和发布。
  • AI 策略草稿:分析一个来源 URL,帮你生成一份策略建议。

自动化需要付费套餐。套餐限制会返回 402 UPGRADE_REQUIRED 或 402 QUOTA_EXCEEDED,用量可以通过 GET /api/v1/automation/quota 查看。

自动化接口返回裸 JSON 对象,没有 success / data 包装。

策略

操作接口
列表 / 详情GET /api/v1/automation/strategies、GET /api/v1/automation/strategies/{id}
创建POST /api/v1/automation/strategies(每小时 10 次)
修改PATCH /api/v1/automation/strategies/{id}
暂停 / 恢复调度POST …/{id}/pause、POST …/{id}/resume
立即执行POST …/{id}/execute
删除DELETE /api/v1/automation/strategies/{id}

创建时的必填字段:

字段含义
association_id要发布到的 connectionId。每个连接只能有一个策略。
platform该连接的平台:youtube、tiktok、instagram、facebook、x 或 linkedin。
source_platformdouyin、xiaohongshu 或 bilibili。
target_url来源创作者的主页 URL。
distribute_config至少一个发布时段,每个时段带一个 cron_expression。
video_config每条视频的处理方式(配音、字幕、标题等),见接口参考页。

常见问题:

响应原因
409 STRATEGY_EXISTS这个连接已经有策略了。传 "replace": true 覆盖。
409 STRATEGY_OWNED_BY_OTHER这个连接的策略属于另一个账号。
403 ACCOUNT_NOT_OWNED / 404 ACCOUNT_NOT_FOUNDassociation_id 不是你已连接的账号。
400 INVALID_SOURCE_URL / 400 INVALID_CRONtarget_url 或 cron_expression 不合法。
409 HAS_RUNNING_TASKS(删除时)还有任务在执行。等它们结束或取消后再试。
409 ACCOUNT_UNLINKED(恢复时)该连接已经没有平台授权,请先在控制台重新连接。

GET /api/v1/automation/dispatch-failures 列出今天没能抓到视频的策略及原因。

任务

GET /api/v1/automation/tasks 返回任务列表,带 status 和处理步骤 step。

status含义
running正在处理(下载、翻译、配音、渲染等),step 显示当前步骤。
pending_review已处理完,等你确认、重新处理或取消。
final_review / pending_publish已确认,排队等待发布。
success已发布。
failed处理或发布失败,原因见 final_error。
cancelled你取消了它。
操作接口适用状态
确认并发布POST /api/v1/automation/tasks/{id}/confirmpending_review
修改后重新处理POST …/{id}/reprocesspending_review
取消POST …/{id}/cancelpending_review
修改标题 / 译文POST …/{id}/title-description你名下的任意任务
重试POST …/{id}/retryfailed

对不在待审核状态的任务调用 confirm、reprocess 或 cancel,会返回 404 TASK_NOT_FOUND。对没有失败的任务调用 retry,会返回 409 TASK_NOT_FAILED。

AI 策略草稿

  1. POST /api/v1/automation/ai-strategy/drafts,传 sourceUrl、targetLanguages、wantSubtitles、wantWatermarkRemoved、associationId 和 dailyCrons, 返回 draftId。每小时最多 5 次、每天最多 10 次(超出返回 429 RATE_LIMITED)。
  2. 轮询 GET /api/v1/automation/ai-strategy/drafts/{draftId},status 依次是 queued → probing → analyzing → drafting → ready(或 failed)。
  3. 到 ready 后,用 POST /api/v1/automation/strategies 按草稿建议创建策略。

在 ready 或 failed 状态下,可以 POST …/{draftId}/regenerate 重新生成(其他状态返回 409 NOT_READY), 也可以 POST …/{draftId}/discard 丢弃(重复丢弃返回 409 ALREADY_DISCARDED)。

本页目录