跳转到正文
使用文档

搜索文档

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

正在加载公开搜索索引…

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

准备视频上传

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

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

操作

POST /video-uploads

operationId: create_video_upload_v1_video_uploads_post

创建私有视频上传会话(MP4/MOV/WebM,最大 100 MiB、2–30 秒)。按返回 URL 和请求头 PUT 准确字节,再完成会话。计入账户存储配额,不启动推理或生成。

鉴权与副作用

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

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

参数

无路径、查询或操作专属请求头参数。

请求体 (application/json)

请求体必填:true

字段 类型 必填 默认值 约束 含义
byte_size integer 是 — maximum: 104857600; exclusiveMinimum: 0 准确字节数,最大 100 MiB;来源须为 2–30 秒。
filename string 是 — minLength: 1; maxLength: 240 客户端文件名,不是服务端可读取的路径。
mime_type string 是 — enum: "video/mp4", "video/quicktime", "video/webm" 实际 MP4、MOV 或 WebM 类型。

完整嵌套结构:VideoUploadRequest

响应

HTTP 正文 含义
201 VideoUploadSession 成功的公开响应,示例数值仅用于说明。
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
{
  "expires_at": "2026-08-30T00:00:00Z",
  "headers": {
    "Content-Type": "video/mp4",
    "X-AnimGen-Upload-Token": "illustrative-only"
  },
  "max_bytes": 104857600,
  "method": "PUT",
  "upload_id": "00000000-0000-4000-8000-000000000001",
  "upload_url": "https://uploads.example.invalid/illustrative-video"
}

相关教程

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

这篇文档有帮助吗?

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

需要帮助?联系支持