上传视频

POST

/power/v1/uploads/videos

把本地视频、Base64 视频或远程 HTTPS 视频转换为一个可公开访问的 ClawPower 临时 URL，供需要视频 URL 的模型接口使用。

• 支持 MP4 和 MOV，视频实体最大 50 MiB，整个 HTTP 请求体最大 70 MiB。
• 上传免费，不消耗任何模型额度。
• 返回的 URL 无需鉴权即可访问，文件保留 72 小时，到期后自动删除。
• 每次请求只能提供一种视频来源：multipart 文件、base64 或 url。
• 服务端不转码，会根据实际 MP4/MOV 容器返回 MIME、字节数和容器时长。

• 远程 URL 搬运最长等待 60 秒；搬运成功后，源 URL 变更或删除不影响已保存的副本。
• 上传成功只代表容器结构通过校验；具体视频模型仍可能限制编码、profile、分辨率或时长。

价格

免费

视频上传不消耗任何模型额度。文件保留 72 小时，到期后自动删除。

认证

使用 ClawPower API Key 进行 Bearer 认证，并在请求头中传入：

Authorization: Bearer <CLAWPOWER_API_KEY>

类型 HTTP (bearer)

请求体

multipart/form-data

模式

请求体

multipart/form-data

视频文件，只能出现一次。支持 MP4、MOV，最大 50 MiB。原始文件名不会被保存。

格式"binary"

响应

上传成功。返回可直接使用的公开 URL 和容器时长。

Content-Type

application/json

{

  

"id": "01KABCDEF123456789",

  

"media_type": "video",

  

"url": "https://files.clawpowerai.com/video/01KABCDEF123456789.mp4",

  

"content_type": "video/mp4",

  

"bytes": 23568000,

  

"duration": 10.24,

  

"created_at": 1787713200,

  

"expires_at": 1787972400

}

POST

/power/v1/uploads/videos

试验场

授权

bearerAuth

主体

示例

命令行示例

上传本地视频（multipart/form-data）：

curl https://api.clawpowerai.com/power/v1/uploads/videos \
  -H "Authorization: Bearer <CLAWPOWER_API_KEY>" \
  -F "file=@my-video.mp4"

通过 Base64 上传（application/json）：

Data URI 形式（推荐，自带 content-type）：

curl https://api.clawpowerai.com/power/v1/uploads/videos \
  -H "Authorization: Bearer <CLAWPOWER_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"base64": "data:video/mp4;base64,AAAAHGZ0eXBpc29t..."}'

纯 Base64 形式（必须同时传 content_type）：

curl https://api.clawpowerai.com/power/v1/uploads/videos \
  -H "Authorization: Bearer <CLAWPOWER_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"base64": "AAAAHGZ0eXBpc29t...", "content_type": "video/mp4"}'

把远程 HTTPS 视频搬运为 ClawPower URL（application/json）：

curl https://api.clawpowerai.com/power/v1/uploads/videos \
  -H "Authorization: Bearer <CLAWPOWER_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/source/video.mp4"}'

格式与模型兼容性

• 上传接口支持结构有效的 MP4 和 MOV，会根据实际容器返回 content_type、扩展名和 duration，不信任原文件名或 URL 后缀。
• 上传时不转码。上传成功只表示容器结构通过校验；具体视频模型仍可能因编码、profile、分辨率或时长限制拒绝该文件。

公开访问与保留期

• 返回的 url 不需要 API Key 或签名参数，任何持有该 URL 的客户端都可以直接 GET/HEAD 访问，也可以直接传给需要视频 URL 的模型接口。
• 文件在 expires_at 之前保证可用；到期后会在之后任意时刻被自动删除，客户端应在到期前把仍需使用的视频转存到自己的存储。
• 上传不返回原始文件名，也不会把原始文件名保存到 URL、存储对象或元数据中。
• 上传不提供幂等保证：重试同一个视频会生成新的 ID 和 URL。