加载接口文档…
九宫格切图
API上传一张图片（multipart 文件 / base64 / URL 三选一），自动居中裁切为正方形后均分为 N×N 宫格小图，按朋友圈发图顺序返回（左到右、上到下编号 1..N²）。支持 2×2 / 3×3 / 4×4，可设置切片间留白，输出 base64 数组或直接下载 zi…
由 极数本源 提供·更新于 2 天前
106
累计调用
478ms
平均响应
100.00%
服务可用性
5,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 2,000 次 · QPS 1
登录免费
当前方案每日 5,000 次 · QPS 2
黄金会员
每日 50,000 次 · QPS 10
钻石会员
每日 100,000 次 · QPS 30
企业会员
企业接口额度 · QPS 120
接入文档
在线工具
接口请求地址
https://v1.apizero.cn/api/nine-grid-cutter
接口请求方式
POST
请求参数格式
MULTIPART/FORM-DATA
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/nine-grid-cutter
接口信息备注
匿名可调用：QPS 1 / 每日 20 次。登录用户：QPS 2 / 每日 50 次。图像处理消耗资源较大。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| file | file | 可选 · 图片文件（multipart 上传，三选一之一），支持 jpg/png/webp/gif |
| image_base64 | string | 可选 · 图片 base64（dataURL 或纯 base64，三选一） |
| image_url | string | 可选 · 公网图片 URL（http/https，三选一） |
| grid | number | 可选 · 宫格数：2 / 3 / 4，默认 3 · 示例：3 |
| gap | number | 可选 · 切片间留白像素 0-20，默认 0 · 示例：0 |
| output | string | 可选 · 输出格式：base64（默认，JSON）/ zip（直接返回 application/zip） · 示例：base64 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| grid | string | 实际宫格规格，如 "3x3" | ||||||||||||
| total | number | 切片总数（grid×grid） | ||||||||||||
| gap | number | 切片间留白像素 | ||||||||||||
| original_size | string | 原图尺寸 W×H | ||||||||||||
| square_side | number | 居中裁切的正方形边长 | ||||||||||||
| cell_size | string | 每张切片尺寸（含 gap 后的实际像素） | ||||||||||||
| source | string | 输入来源：multipart / base64 / url | ||||||||||||
| pieces | array | 切片数组，每项含 index / size / base64 / data_url（可直接 <img src=> 用） | ||||||||||||
| ||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"grid": "3x3",
"total": 9,
"gap": 0,
"original_size": "1080x1920",
"square_side": 1080,
"cell_size": "360x360",
"source": "multipart",
"pieces": [
{
"index": 1,
"size": "360x360",
"base64": "iVBORw0K...",
"data_url": "data:image/png;base64,iVBORw0K..."
},
{
"index": 2,
"size": "360x360",
"base64": "...",
"data_url": "..."
}
]
},
"request_id": "abc123",
"tips": "极数本源 · https://apizero.cn"
}免责声明
单图最大 10MB，最长边不超过 6000px。GIF 等多帧图只取首帧。