图片裁剪

开发环境

http://127.0.0.1:8001

POST

/api/v1/wx/tools/image/crop

图片裁剪接口

支持三种图片输入方式（优先级从高到低）：

file: 上传文件

image_url: 图片URL地址

image_base64: Base64编码的图片

裁剪参数：

aspect_ratio: 目标比例，如 '16:9', '4:3', '1:1' 或自定义 '800:600'

width/height: 目标尺寸（可选，同时指定会缩放到精确尺寸）

mode: 裁剪方式

center: 居中裁剪

top: 顶部裁剪

bottom: 底部裁剪

left: 左侧裁剪

right: 右侧裁剪

top-left: 左上角裁剪

top-right: 右上角裁剪

bottom-left: 左下角裁剪

bottom-right: 右下角裁剪

output_format: 输出格式 (png/jpeg/webp)

return_base64: 是否返回base64，默认返回文件下载

请求参数

Authorization

OAuth 2.0

Password

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: /api/v1/wx/auth/token

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://127.0.0.1:8001/api/v1/wx/tools/image/crop' \
--form 'file=""' \
--form 'image_url=""' \
--form 'image_base64=""' \
--form 'aspect_ratio=""' \
--form 'width=""' \
--form 'height=""' \
--form 'mode="center"' \
--form 'output_format="png"' \
--form 'return_base64="false"'

返回响应

🟢200

application/json

Successful Response

Bodyapplication/json

示例

null

🟠422

修改于 2026-06-12 17:49:50

删除导出文件(查询参数)

下载裁剪后的图片