用量查询
POST/files

上传输入图

校验、规范化并保存一张可用于浮雕、AI 设计或圆雕的源图片;上传成功消耗 1 API 点。

算力消耗

1 算力点
API 标价:1 算力点

分层计费时,已享充值优惠的算力包优先按原规则消费;合同包按绑定合同计价,实际扣点以调用结果为准。

代码示例

curl --request POST \
  --url 'https://www.cjzmai.com/v2/files' \
  --header 'Authorization: Bearer sk-your-api-key' \
  --form 'file=@input.png'

请求参数

filebinary必填
示例: input.png可选: PNG, JPEG, WebP, BMP, GIF

通过 multipart/form-data 上传文件,支持 PNG、JPEG、WebP、BMP 和 GIF。

Idempotency-Keyheader可选
默认: 可不填示例: upload-request-001

可选的安全重试键;不提供时,每次重复提交都会被视为新的可计费请求。

  • 只提交一次且不自动重试时可以不填。超时或网络中断后,应为完全相同的请求复用同一个稳定唯一键,避免重复扣费。
  • 同一个键不能用于不同参数;换一个新键会创建新请求并再次扣费。

响应示例

200application/json
{
  "id": "file_...",
  "object": "file",
  "purpose": "relief_input",
  "mime_type": "image/png",
  "bytes": 842311,
  "width": 2048,
  "height": 2048,
  "url": "https://...",
  "created_at": "2026-08-05T00:00:00Z"
}
关注我们
抖音小红书快手哔哩哔哩今日头条
© 2024 杭州仓颉造梦数字科技有限公司

浙ICP备2024069408号-1

浙公网安备33011302001161号