主题
上传图像
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)
请求体
multipart/form-data模式
请求体
multipart/form-data
图像文件,只能出现一次。支持 JPEG、PNG、WebP,最大 20 MiB。原始文件名不会被保存。
格式
"binary"响应
上传成功。返回可直接使用的公开 URL。
application/json
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
{
}
命令行示例
上传本地图像(multipart/form-data):
bash
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):
bash
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):
bash
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):
bash
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。
