POST/files

上传输入图

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

算力消耗

1 算力点

调用该接口消耗 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, or GIF

Idempotency-Keyheader可选

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

Optional; reuse for an exact retry

响应示例

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"
}