加载接口文档…
75
累计调用
4ms
平均响应
100.00%
服务可用性
5,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 2,000 次 · QPS 1
登录免费
当前方案每日 5,000 次 · QPS 2
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/nine-grid-cutter/raw.md接口请求地址
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 等多帧图只取首帧。