传输视频字节
从源码生成 PUT /video-uploads/{upload_id}/content 的鉴权、字段、响应、错误与安全调用参考。
本页目录
操作
PUT /video-uploads/{upload_id}/content
operationId: transfer_video_upload_v1_video_uploads__upload_id__content_put
按返回的 PUT URL 和 X-AnimGen-Upload-Token 传输原视频字节,不附加 API/OAuth 凭据。准确匹配 Content-Type 和 byte_size。即使没有 Content-Length 也限制流式字节数;使用文件 ID 前需完成上传。
鉴权与副作用
使用返回的完整签名 URL,不携带 Bearer Key。
此操作不启动付费生成,其他状态变化见上文说明。
参数
| 参数 | 位置 | 类型 | 必填 | 约束 / 默认值 | 含义 |
|---|---|---|---|---|---|
upload_id |
path |
string |
是 | format: uuid |
所属公共资源 UUID;任务、资产、文件 ID 不能互换。 |
X-AnimGen-Upload-Token |
header |
string |
是 | — | — |
请求体 (application/octet-stream)
请求体必填:true
没有对象字段,参见 Schema 类型与约束。
响应
| HTTP | 正文 | 含义 |
|---|---|---|
204 |
— | 视频字节已传输,接下来完成上传会话。 |
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 |
建议等待秒数,遵循服务值并设置总体截止时间。 |
相关教程
这篇文档有帮助吗?
不收集搜索词、代码或自由文本。此开关只控制文档交互事件;站点通用分析仍遵循隐私政策。 隐私政策