mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
f858c4cea0
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
2.6 KiB
2.6 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| 将图像并排、堆叠或以网格方式拼接，可控制对齐、间距、边框和调整模式。 | 670c5cc944b1 | human | 87525c98302e |
拼接合并图片
将多张图像并排、垂直堆叠或以网格排列的方式拼接。支持对齐、间距、边框、圆角和多种调整模式。
API 端点
POST /api/v1/tools/image/stitch
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| direction | string | 否 | "horizontal" |
布局方向：horizontal、vertical、grid |
| gridColumns | integer | 否 | 2 | 当方向为 grid 时的列数（2 到 100） |
| resizeMode | string | 否 | "fit" |
图像调整方式：fit、original、stretch、crop |
| alignment | string | 否 | "center" |
交叉轴对齐：start、center、end |
| gap | number | 否 | 0 | 图像之间的间距（像素，0 到 1000） |
| border | number | 否 | 0 | 外边框宽度（像素，0 到 500） |
| cornerRadius | number | 否 | 0 | 应用于最终输出的圆角（0 到 500） |
| backgroundColor | string | 否 | "#FFFFFF" |
背景/边框颜色，十六进制（例如 #FF0000） |
| format | string | 否 | "png" |
输出格式：png、jpeg、webp、avif、jxl |
| quality | number | 否 | 90 | 输出质量（1 到 100） |
示例请求
curl -X POST http://localhost:1349/api/v1/tools/image/stitch \
-F "file=@image1.png" \
-F "file=@image2.png" \
-F "file=@image3.png" \
-F 'settings={"direction":"horizontal","resizeMode":"fit","gap":10,"backgroundColor":"#FFFFFF","format":"png"}'
示例响应
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/stitch.png",
"originalSize": 1234567,
"processedSize": 987654
}
说明
- 至少需要 2 张图像。在 multipart 请求中上传多个图像文件。
- 支持 HEIC、RAW、PSD 和 SVG 输入格式（自动解码）。
- 调整模式：
fit- 沿拼接轴将图像缩放至匹配最小尺寸。original- 保持原始尺寸（可能产生不齐的边缘）。stretch- 强制图像匹配最小尺寸，不保持宽高比。crop- 覆盖裁剪图像以匹配最小尺寸。
- 在
grid模式下，单元格大小设为所有图像尺寸的中位数。 cornerRadius应用于整个最终输出，而非单张图像。- 画布大小受
MAX_CANVAS_PIXELS服务器配置限制，以防止内存耗尽。