准备视频上传
从源码生成 POST /video-uploads 的鉴权、字段、响应、错误与安全调用参考。
本页目录
操作
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 |
建议等待秒数,遵循服务值并设置总体截止时间。 |
响应示例
{
"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"
}
相关教程
这篇文档有帮助吗?
不收集搜索词、代码或自由文本。此开关只控制文档交互事件;站点通用分析仍遵循隐私政策。 隐私政策