拼接图片
拼接图片 是有文档说明的 APIAny 免费 API 工具：先在浏览器试用，再用 API 密钥调用同一操作。
横向或纵向拼接最多 20 张图片，并可设置间距。
POST /api/free/join-images来源
本页引用了哪些官方资料？
以下引文来自 APIAny 对照实现的官方 API 文档。
The Fetch API provides an interface for fetching resources (including across the network).
The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP and AVIF images of varying dimensions.
The Images API provides several endpoints that let you generate images from text prompts or create edits of existing images.
在线拼接图片
上传、设置、预览与下载都不需要 API Key。
1. 上传与设置
无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。
2. 预览与下载
包含预览、文件大小变化和下载按钮
通过 API 接入
仅程序调用需要 API Key；参数、响应和错误信息集中展示。
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 状态码。