跳转到正文
使用文档

搜索文档

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

正在加载公开搜索索引…

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

传输视频字节

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

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

操作

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 建议等待秒数,遵循服务值并设置总体截止时间。

相关教程

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

这篇文档有帮助吗?

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

需要帮助?联系支持