跳转到正文
使用文档

搜索文档

搜索只在此浏览器中进行,关键词不发送、不保存。请勿粘贴凭据。

正在加载公开搜索索引…

Tab 或方向键选择 · Enter 打开 · Esc 关闭
浏览文档目录

完成视频上传

从源码生成 POST /video-uploads/{upload_id}/complete 的鉴权、字段、响应、错误与安全调用参考。

公开测试API v1 · 1.5.0最后核实
本页目录

操作

POST /video-uploads/{upload_id}/complete

operationId: finish_video_upload_v1_video_uploads__upload_id__complete_post

校验上传来源元信息并返回可复用视频 file_id,重复完成返回同一文件。不启动深度处理;生成时在 input.reference_video 指定合法选区。原视频上限 30 秒,选区 2–5 秒,受模型更低上限约束。

鉴权与副作用

使用可信环境中的 Bearer API Key。所需权限:animations:write

此操作不启动付费生成,其他状态变化见上文说明。

参数

参数 位置 类型 必填 约束 / 默认值 含义
upload_id path string 是 format: uuid 所属公共资源 UUID;任务、资产、文件 ID 不能互换。

响应

HTTP 正文 含义
200 VideoFileResponse 成功的公开响应,示例数值仅用于说明。
400 APIErrorEnvelope 输入错误,修正请求后再尝试。
401 APIErrorEnvelope API Key 缺失、到期或被撤销。
403 APIErrorEnvelope 账户资格、账户状态或 Key 权限不允许此操作。
404 APIErrorEnvelope 资源不可用、不属于当前用户,或签名无效/过期。
409 APIErrorEnvelope 幂等冲突;仅 IDEMPOTENCY_IN_PROGRESS 可复用原请求重试。
410 APIErrorEnvelope 上传会话已到期,请重新创建。
413 APIErrorEnvelope 请求或解码后的图片超过配置限制。
415 APIErrorEnvelope 使用支持的图片媒体类型。
422 APIErrorEnvelope 视频元信息或字节数不合法。
429 APIErrorEnvelope 触发账户级速率或队列限制,遵循 Retry-After 等待。
500 APIErrorEnvelope 内部错误,保留任务 ID 和幂等键,仅标记可重试时重试。
503 APIErrorEnvelope 服务或供应商不可用,仅 error.retryable 为 true 时重试。

响应头

HTTP 响应头 类型 含义
429 Retry-After integer 建议等待秒数,遵循服务值并设置总体截止时间。
503 Retry-After integer 建议等待秒数,遵循服务值并设置总体截止时间。

响应示例

json
{
  "byte_size": 1024,
  "duration_seconds": 5,
  "file_id": "00000000-0000-4000-8000-000000000001",
  "height": 768,
  "mime_type": "video/mp4",
  "object": "file",
  "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
  "width": 768
}

相关教程

轮询与下载 · 错误与安全重试

这篇文档有帮助吗?

不收集搜索词、代码或自由文本。此开关只控制文档交互事件;站点通用分析仍遵循隐私政策。 隐私政策

需要帮助?联系支持