自动化
按计划搬运并本地化视频的策略、策略产生的任务,以及 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_platform | douyin、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_FOUND | association_id 不是你已连接的账号。 |
400 INVALID_SOURCE_URL / 400 INVALID_CRON | target_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}/confirm | pending_review |
| 修改后重新处理 | POST …/{id}/reprocess | pending_review |
| 取消 | POST …/{id}/cancel | pending_review |
| 修改标题 / 译文 | POST …/{id}/title-description | 你名下的任意任务 |
| 重试 | POST …/{id}/retry | failed |
对不在待审核状态的任务调用 confirm、reprocess 或 cancel,会返回 404 TASK_NOT_FOUND。对没有失败的任务调用 retry,会返回 409 TASK_NOT_FAILED。
AI 策略草稿
POST /api/v1/automation/ai-strategy/drafts,传sourceUrl、targetLanguages、wantSubtitles、wantWatermarkRemoved、associationId和dailyCrons, 返回draftId。每小时最多 5 次、每天最多 10 次(超出返回429 RATE_LIMITED)。- 轮询
GET /api/v1/automation/ai-strategy/drafts/{draftId},status依次是queued→probing→analyzing→drafting→ready(或failed)。 - 到
ready后,用POST /api/v1/automation/strategies按草稿建议创建策略。
在 ready 或 failed 状态下,可以 POST …/{draftId}/regenerate 重新生成(其他状态返回 409 NOT_READY),
也可以 POST …/{draftId}/discard 丢弃(重复丢弃返回 409 ALREADY_DISCARDED)。