图片拼接九宫格

接口标识: imagecollage 价格: 0.3 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

图片拼接接口把 2~9 张图片按横向、纵向或近正方形网格自动布局，合成一张大图。图片间隔 0~100 像素与留白底色可自定义；可统一正方形单元格让不同尺寸的图片居中裁切对齐，也可指定目标总宽等比缩放产物；单张最大 20MB，EXIF 方向自动纠正，产物为 PNG。适合社交九宫格发布、电商详情页多图拼接、方案对比图与展示墙排版等场景。

详细介绍

![图片拼接九宫格接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_imagecollage__1794363359_257b0962e237.png)

九宫格发布、详情页长图、前后对比图这类需求，用修图软件手工对齐粘贴费时费力。图片拼接接口把 2~9 张图片按横向、纵向或网格自动布局，一次合成一张成品大图。

## 接口概述
面向社交媒体、电商、家装设计与展览展示等场景，传入 2~9 张图片的数组并指定布局方式，接口自动计算行列、按指定底色留白逐张贴合，返回拼接后大图的下载地址与宽高信息。网格布局自动计算接近正方形的行列数；图片之间的间隔与留白底色可自定义；开启统一正方形单元格后，不同尺寸的图片会居中裁切成一致规格；还可指定目标总宽对产物整体等比缩放。成品可直接用于社媒发布、详情页素材与打印输出。

## 核心能力
1. **三种布局**：horizontal 单行横排、vertical 单列纵排、grid 近正方形网格（默认），行列数按图片数量自动计算。
2. **统一单元格**：设定 cell_size 后所有图片居中裁切为同尺寸正方形，图源大小不一也能整齐划一。
3. **间隔与底色**：图片间隔 0~100 像素可调，间隔与留白底色可用十六进制色值自定义，默认白色。
4. **产物尺寸控制**：可按目标总宽对整图等比缩放，适配不同展示位与打印规格。
5. **广泛兼容**：单张最大 20MB，每张图 EXIF 方向自动纠正，产物以 PNG 格式输出。

## 产品优势
1. **接入简单**：一次 POST 传图片数组与布局参数即得成品大图地址。
2. **响应迅速**：拼接合成在平台服务器本地完成，无需等待第三方服务。
3. **稳定可靠**：无外部依赖即无上游抖动风险；图片数量与单张大小均有明确校验。
4. **准确规范**：单元格自动居中对齐、间隔均匀，避免手工粘贴的错位问题。
5. **降本增效**：替代修图软件手工排版，批量出图场景可全自动化。
6. **生态开放**：与平台其余接口共用同一套签名与响应结构，接入一次处处复用。

## 效果展示
一句话理解：它就像一位「照片墙排版师」，你把几张图交给它并说清横排、竖排还是网格，它对齐间距、选好底色，整齐地贴成一张大图。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| files | 见下方请求示例 | 图片数组 2~9 张，每张支持公网URL、Base64（data:开头）与平台文件ID（fileid_开头），单张不超过 20MB |
| layout | grid | 布局：horizontal 横排 / vertical 纵排 / grid 网格，默认 grid |
| spacing | 10 | 图片之间的间隔像素 0~100，默认 0 |
| bg_color | #FFFFFF | 间隔与留白底色，十六进制，默认白色 |
| cell_size | 800 | 统一正方形单元格边长（像素），每张图居中裁切；不传则按各图原始纵横比 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 拼接大图下载地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261110/collage_20261110_180000.png | `image_url`，产物为 PNG 格式 |
| 产物宽度 | 1630 | `width`，2 列 × 800 像素 + 3 段 10 像素间隔 |
| 产物高度 | 1630 | `height`，2 行 × 800 像素 + 3 段 10 像素间隔 |
| 参与拼接张数 | 3 | `count`，实际参与拼接的图片数量 |

API请求示例：

```
POST /api/imagecollage
files=["https://example.com/demo/sofa_1.jpg","https://example.com/demo/sofa_2.jpg","https://example.com/demo/sofa_3.jpg"]&layout=grid&spacing=10&cell_size=800
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "image_url": "https://fujian.phpwc.com/pyapi/uploads/api/20261110/collage_20261110_180000.png",
    "width": 1630,
    "height": 1630,
    "count": 3
  },
  "request_id": "req-imagecollage-demo-001"
}
```

本例 3 张图按 grid 布局自动排成 2 行 2 列，最后一个空位以白色留白补齐；不希望出现空位时可改用 horizontal 单行横排，或凑足 4 张再走网格。

## 应用场景
1. **社交发布**：多张照片自动合成九宫格大图，一条动态完整呈现。
2. **电商详情页**：商品多角度图拼接成长图，减少详情页图片数量。
3. **家装建材**：效果图、材料图、施工图拼成方案对比图给客户确认。
4. **展览展示**：展位与作品缩略图批量合成展示墙大图，直接送印。
5. **前后对比**：两张图横排或纵排拼接，改造与护理效果一目了然。

## 应用案例
一家家装 SaaS 平台需要在设计师选材后自动生成「材料拼图」发给业主，此前靠设计师在修图软件里手工拼贴再回传，流程周期长；接入接口后系统在选材完成时自动生成网格拼图，业主当场即可确认方案。

一家二手奢侈品门店每天要在社交平台发商品九宫格，店员逐张对齐排版耗时耗力；改由接口固定 cell_size 输出统一正方形单元格后，版面风格整齐划一，发布效率明显提升。

一家会展公司需要把数十张展位缩略图拼成展示墙大图，此前外包给设计工作室处理；现在用脚本按目标总宽批量调用接口拼接，成品直接进入打印流程，省去了一道外包环节。

常见问题

Q：最多能拼几张图？

A：2~9 张；不足 2 张或超过 9 张会返回参数错误，每张图片最大 20MB。

Q：grid 网格布局怎么排行列？

A：按图片数量自动计算接近正方形的行列数，例如 3 张排成 2 列 2 行，最后一个空位以背景色留白补齐。

Q：图片尺寸不一致会怎样？

A：默认每张图保持原始纵横比，在最大尺寸的单元格内居中放置；设置 cell_size 后所有图片居中裁切为同一尺寸的正方形，版面更整齐。

Q：产物是什么格式？

A：拼接产物统一输出 PNG 格式，返回的 width 与 height 为产物实际像素尺寸。

图片拼接九宫格多图合并拼图图片排版

接口地址： https://www.phpwc.cn/api/imagecollage

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`files`	array	必填	-	图片数组，2~9 张，每项为三形态 file（图片/文件，支持三形态：公网URL / data:image;base64编码 / file_id(fileid_开头)），单张 ≤20MB
`layout`	string	选填	-	布局：horizontal / vertical / grid，默认 grid
`spacing`	int	选填	-	图片间隔像素 0~100，默认 0
`bg_color`	string	选填	-	间隔与留白底色 hex，默认 #FFFFFF
`target_width`	int	选填	-	产物总宽度（等比适配），默认不缩放
`cell_size`	int	选填	-	统一正方形单元格边长（居中裁切），如 800，默认按原图纵横比

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`image_url`	string	拼接产物下载地址
`width`	int	产物宽度（像素）
`height`	int	产物高度（像素）
`count`	int	参与拼接的图片数
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试