AiVideoEditor
免费开始
菜单

审校于 2026-11-11 · API 版本 2026-11-09 · 阅读 Markdown

发布与排期

一个 AiVideoEditor 帖子有一个带版本的草稿,以及针对其所选账号的独立交付。草稿保存是宽松的;保存成功并不表明每个目标都可发布。

准备帖子

  1. 使用预期的密钥读取 /api/v1/accounts 和 /api/v1/capabilities。
  2. 上传并完成所需的媒体。
  3. 使用 POST /api/v1/posts 创建草稿,或使用 PATCH /api/v1/posts/{id} 编辑。编辑时提供当前 expectedVersion,并保留返回的版本。
  4. 在需要时设置目标格式以及明确的按账号变体覆盖。API 参考定义了请求字段。
  5. 使用 POST /api/v1/posts/{id}/validate 进行校验。HTTP 200 可能包含 valid: false;提交前检查每个问题。无效账号不会被悄悄地从受众中移除。

立即发布或稍后发布

POST /posts/{id}/publish 提交当前草稿。POST /posts/{id}/schedule 需要 scheduledAt、timezone 和 expectedVersion。排期时刻必须是未来时间且在 90 天内。存储一个 UTC ISO 时间戳和一个单独的 IANA 显示时区;发送前解决夏令时歧义。

为每个新变更操作使用不同的 Idempotency-Key。发送前保留该密钥和确切的请求体。超时后,使用相同密钥重放完全相同的请求。只有有意请求新操作时才更换密钥。过期的草稿编辑或排期会返回 revision_conflict;请重新读取并审查最新内容,而不是盲目覆盖。

202 响应表示已被接受待分发。它不是已发布的证据。记录交付 ID 并观察 GET /posts/{id} 或已签名的客户 webhook。使用延迟递增的有界轮询;在得到终态结果或需要人工交接时停止,而不是无限循环。

按目标的结果

交付可以独立完成。一个目标可能已发布,而另一个需要重新连接或同意。显示每个状态以及原生帖子链接(如果存在)。仅使用 POST /deliveries/{id}/retry 重试符合条件的已知失败。不得为了恢复失败的目标而重新创建已成功的目标。未知的外部结果需要核对或审查,而不是重新提交。

在工作仍安全未领取时使用 POST /deliveries/{id}/cancel 取消。too_late_to_cancel 表示提交已进行到超出安全取消的范围;它不表示外部帖子已被移除。

TikTok 人工审查

读取 /accounts/{id}/tiktok/settings 获取当前创作者设置和可用的隐私选择。读取设置或保存草稿不构成同意。consent_required 包含指向已认证编辑器的安全 requiresAction 交接。授权人员在那里审查确切的视频、文案和目标,并明确确认所需的选择。产品密钥和 MCP 工具无法代其确认。内容或身份更改需要重新审查。交接本身不授予成员资格或访问权。

编辑器控件

使用 添加媒体 上传文件或选择现有库中的项目。文案在 自定义内容 创建特定账号的变体之前是共享的。表情符号和话题标签工具在光标处插入普通文本。

发布选项 将所选账号的设置分组。必选项保持可见;可选项保持折叠。更改仅应用于该账号。预览 显示生效的草稿而不保存或提交它,包括不完整的草稿;原生平台呈现可能不同。

为排期的封面和缩略图使用私有资产引用。公共 URL 替代方案必须在交付时仍然可访问。字幕内容与不可变设置一起存储,而不是依赖于临时本地文件。LinkedIn 文档上传目前接受 PDF;Office 格式在实现签名验证之前仍受限。

规范控件和集成限制参见能力参考。新的格式和确认行为在部署前需要相应的数据库迁移。