CZL 图床 API 文档

• HTML 文档: https://img.czl.net/api-docs.html
• Markdown 文档: https://img.czl.net/api-docs.md
• 旧地址兼容: https://img.czl.net/page/api-docs.html
• API Base URL: https://img.czl.net/api/v1

接入说明

• 所有接口都返回 JSON。
• 当前版本接口采用「Bearer Token」的方式验证授权，从个人中心获取 Token 后，通过 Authorization 请求头传递，例如：Authorization: Bearer 1|1bJbwlqBfnggmOMEZqXT5XusaIwqiZjCDs7r1Ob5。
• 上传接口使用 multipart/form-data，文件字段名固定为 file。
• POST /upload 在未携带 Authorization 时会按游客上传处理；是否允许游客上传取决于后台配置。
• GET /strategies 在未登录时会返回游客组可用策略；登录后返回当前用户组可用策略。
• 文档中接口的请求参数，使用红色「*」符号或"必填=是"标注，则表示为必传项。

统一响应结构

{
  "status": true,
  "message": "success",
  "data": {}
}

公共请求 headers

公共响应 headers

响应状态码 HTTP Status Code 说明

快速示例

获取当前用户资料

curl --request GET "https://img.czl.net/api/v1/profile" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_TOKEN"

上传图片

curl --request POST "https://img.czl.net/api/v1/upload" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_TOKEN" \
  --form "file=@/path/to/demo.png" \
  --form "strategy_id=1" \
  --form "permission=0"

用户相关

GET /profile

获取当前登录用户资料。

• 认证要求: 必须登录
• 请求参数: 无

返回参数:

策略相关

GET /strategies

获取当前用户组可用的储存策略列表。

• 认证要求: 可匿名；未登录时返回游客组可用策略，登录时按当前用户组返回
• 请求体类型: 无

请求参数(Query):

返回参数:

图片相关

POST /images/tokens

生成临时上传 Token。

• 认证要求: 必须登录
• 请求体类型: application/json 或表单均可

请求参数(Body):

返回参数:

POST /upload

上传图片。

• 认证要求: 可匿名；登录后可使用用户能力、相册、默认策略等
• 请求体类型: multipart/form-data

Headers:

请求参数(Body):

补充说明:

• 当用户组配置了固定过期时间时，自定义 expired_seconds / expired_at 会被系统策略覆盖。
• 自定义删除时间最长不能超过 1 年。
• 如果不传 strategy_id，系统会优先使用用户默认策略，否则回退到当前组的第一个可用策略。

返回参数:

GET /images

分页获取当前用户的图片列表。

• 认证要求: 必须登录

请求参数(Query):

返回参数:

DELETE /images/{key}

删除指定图片。

• 认证要求: 必须登录

请求参数(Params):

返回参数:

相册相关

GET /albums

分页获取当前用户的相册列表。

• 认证要求: 必须登录

请求参数(Query):

返回参数:

DELETE /albums/{id}

删除指定相册。

• 认证要求: 必须登录

请求参数(Params):

返回参数:

给 AI / 插件作者的建议

• 优先读取这份 Markdown 文档，而不是解析页面 DOM。
• 上传接口必须使用 multipart/form-data，并确认文件字段名是 file。
• 分页接口请按统一响应结构读取 data.current_page、data.last_page、data.total 和 data.data。
• 如果你在做 WordPress、Obsidian、Raycast、n8n、Dify、Coze、浏览器扩展或自定义 SDK，建议先接通 GET /strategies、POST /upload、GET /images 这三条主链路。