拼接图片

横向或纵向拼接最多 20 张图片，并可设置间距。

POST /api/free/join-images

在线拼接图片

上传、设置、预览与下载都不需要 API Key。

无需登录或 API Key

1. 上传与设置

无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。

图片文件 *

点击选择多个文件，或拖拽到这里JPG · PNG · WebP · AVIF · 30 MB · ×20只有运行工具时才会上传文件。

拼接方向

间距

背景颜色

输出格式

填写必填参数后即可运行工具。POST /api/free-online/join-images

2. 预览与下载

结果将在这里显示

包含预览、文件大小变化和下载按钮

通过 API 接入

仅程序调用需要 API Key；参数、响应和错误信息集中展示。

API 接口

POST /api/free/join-images

在线使用免 Key；程序调用此接口时需要 APIAny Key。

工作原理

图片会对齐拼接，不会向上放大。
最终画布每边最多 8192 像素。

响应结果

请求成功后返回 image 类型响应，Content-Type 与本页说明一致。

常见错误

400: 缺少文件或参数、值无效，或者超出页面标注的限制。
401: 程序调用缺少 API Key，或 Key 无效、已停用。
429: 在线或鉴权调用已达到共享限速。

参数与限制

参数	要求	默认值	可用值
`files`图片文件	必填	—	file
`direction`拼接方向	选填	horizontal	horizontal, vertical
`gap`间距	选填	0	number
`background`背景颜色	选填	#ffffff	text
`format`输出格式	选填	webp	webp, png, jpeg

API 调用示例

下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。

curl -X POST "https://apiany.ai/api/free/join-images" \
  -H "Authorization: Bearer $API_KEY" \
  -F "files=@a.png" \
  -F "files=@b.png" \
  -F "direction=horizontal" \
  --output joined.webp

常见问题

使用拼接图片需要 API Key 吗？

在线 Playground 无需 Key；程序请求请通过 Authorization: Bearer 或 X-API-Key 发送 APIAny Key。

拼接图片有哪些使用限制？

在线工具每分钟最多 3 次、每天 30 次；鉴权免费账户为 5 RPM，付费账户为 500 RPM，并在全部免费 API 间共享。

拼接图片支持哪些输入？

请按参数表提供必填与选填字段；不支持的格式和超出范围的值会被拒绝。

拼接图片返回什么？

成功请求返回 image 响应；失败时使用上方列出的 HTTP 状态码。

信息来源：APIAny 免费 API 目录与实际路由行为。内容复核日期：2026-07-17。