为你的应用接入开拍

开拍开放平台。

从视频到草稿，再到成片。用一套 API，连接完整的视频合成工作流。

登录创建 API Key ↗ 文档公开访问

START HERE

接入视频合成

创建密钥 → 上传视频 → 选择模板 → 提交合成 → 查询状态 → 下载 MP4。

登录工作台后创建调用密钥，密钥只显示一次。业务请求与下载携带 Bearer 或 X-API-Key。

上传返回的 id 用作 video_id，模板目录返回 recipe_id。可先导入 SRT，再提交合成请求。

提交 /compositions 后轮询 status。等到 done，使用 export.download_url 下载 MP4。

先上传并获取模板编号，再替换示例中的 VIDEO_ID 和 RECIPE_ID。Windows PowerShell 可使用接口页的 Python 示例。

生成草稿、一键合成、导出、恢复查询各提供两种方式：异步接口受理后返回任务，同步接口以 /sync 结尾，等待完成后返回结果。接口详情可直接切换两种方式。

同步默认等待 120 秒，可用 timeout_seconds 调整到 1–7200 秒。超时返回 504 和原任务编号，后台继续处理。同一业务在同步、异步之间重试时保留原 Idempotency-Key；新业务使用新键。

state 只表示草稿阶段，status 表示完整合成。导出 interrupted 时调用恢复接口查询原任务。

⌁

从左侧接口目录开始查看参数、示例与在线调试。