上传图片

POST

/power/v1/uploads/images

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

• 支持 JPEG、PNG、WebP，单张最大 20 MiB。
• 上传免费，不消耗任何模型额度。
• 上传成功后服务端自动删除图片中的隐私元数据（GPS、设备、作者等），不影响显示方向。
• 返回的 URL 无需鉴权即可访问，文件保留 72 小时，到期后自动删除。
• 每次请求只能提供一种图片来源：multipart 文件、base64 或 url。

• 远程 URL 搬运最长等待 60 秒；搬运成功后，源 URL 变更或删除不影响已保存的副本。
• 上传不返回原始文件名，也不会把它保存到任何地方。

价格

免费

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

认证

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

Authorization: Bearer <CLAWPOWER_API_KEY>

类型 HTTP (bearer)

请求体

application/json

JSON 请求体。base64 与 url 互斥，必须提供且只能提供一个；不允许传入未定义字段。

Data URI（data:image/png;base64,...）或纯 Base64 图片数据。解码后不超过 20 MiB。与 url 互斥。

图片的 MIME 类型。纯 Base64 输入必填；Data URI 输入可省略，传入时必须与 Data URI 声明和图片实际内容一致。只在与 base64 搭配时有效。

可公网访问的 HTTPS 图片地址，不支持需要登录或签名请求头的地址，不允许指向内网地址。与 base64 互斥，不能与 content_type 同时使用。

响应

上传成功。返回可直接使用的公开 URL。

Content-Type

application/json

{

  

"id": "01KABCDEF123456789",

  

"media_type": "image",

  

"url": "https://files.clawpowerai.com/image/01KABCDEF123456789.webp",

  

"content_type": "image/webp",

  

"bytes": 235680,

  

"created_at": 1787477200,

  

"expires_at": 1787736400

}

POST

/power/v1/uploads/images

试验场

授权

bearerAuth

主体

示例

命令行示例

上传本地图片（multipart/form-data）：

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

通过 Base64 上传（application/json）：

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

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

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

curl https://api.clawpowerai.com/power/v1/uploads/images \
  -H "Authorization: Bearer <CLAWPOWER_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"base64": "iVBORw0KGgoAAA...", "content_type": "image/png"}'

把远程 HTTPS 图片搬运为 ClawPower URL（application/json）：

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

公开访问与保留期

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