上传音频

POST

/power/v1/uploads/audios

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

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

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

价格

免费

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

认证

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

Authorization: Bearer <CLAWPOWER_API_KEY>

类型 HTTP (bearer)

请求体

multipart/form-data

模式

请求体

multipart/form-data

音频文件，只能出现一次。支持 MP3、WAV，最大 15 MiB。原始文件名不会被保存。

格式"binary"

响应

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

Content-Type

application/json

{

  

"id": "01KABCDEF123456789",

  

"media_type": "audio",

  

"url": "https://files.clawpowerai.com/audio/01KABCDEF123456789.mp3",

  

"content_type": "audio/mpeg",

  

"bytes": 1843200,

  

"duration": 12.48,

  

"created_at": 1787713200,

  

"expires_at": 1787972400

}

POST

/power/v1/uploads/audios

试验场

授权

bearerAuth

主体

示例

命令行示例

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

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

通过 Base64 上传（application/json）：

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

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

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

curl https://api.clawpowerai.com/power/v1/uploads/audios \
  -H "Authorization: Bearer <CLAWPOWER_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"base64": "SUQzBAAAAA...", "content_type": "audio/mpeg"}'

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

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

格式与模型兼容性

• 上传接口支持结构有效的 MP3 和 WAV，会根据实际音频内容返回 content_type、扩展名和 duration，不信任原文件名、URL 后缀或声明类型。
• 上传时不转码。上传成功只表示文件结构通过校验；具体模型仍可能因编码、时长或素材组合限制拒绝该文件。

公开访问与保留期

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