Photo Collage API：固定插槽布局，适配任意照片
Photo Collage API 接收一个图片 URL 列表，返回一张拼合后的图像。你只需设置一次插槽布局并标记为动态，后续每次渲染都能将新照片填充到相同的几何结构中。
这正是其核心价值所在，也是拖放式拼图工具无法提供的能力。当设计的尺寸固定且插槽位置不变时，400 套房产列表输出的照片位置完全一致。无需手动调整任何元素。
Photo collage maker 免费支持在浏览器中处理单次案例。而这里讨论的是批量处理。
固定画布即核心特性固定画布即核心特性
宽度和高度在设计阶段设定，无法在每次渲染时覆盖。对于拼图而言，这一约束发挥了实际作用。
拼图是一种空间承诺：主图大且位于左上角，细节图沿底部排列，标签位于角落。如果在相邻两个列表之间打破这一承诺，整个画廊看起来就像由不同人员制作。固定插槽通过机械方式维持这一承诺。
这也意味着设计本身即布局决策。双联对比图、三联细节条和六格网格是三种独立设计，而非一个带有照片数量参数的单一设计。这听起来比实际更繁重：每个设计只需几分钟，且之后永不漂移。
每个插槽适配其专属照片每个插槽适配其专属照片
照片以相机或卖家提供的任意形状输入。图像层通过 imageSize 按插槽处理，对应 CSS 的 object-fit：
| 插槽用途 | imageSize | 原因 |
|---|---|---|
| 列表网格中的主图 | cover | 填满插槽；允许裁剪，边缘贴边显得刻意且整洁 |
| 白底产品图 | contain | 裁剪产品不如加黑边（letterboxing） |
| 混合用户上传 | cover 配合焦点 | 在不控制的照片中实现可预测的取景 |
| Logo 或徽章插槽 | none | 原生尺寸，不缩放，无模糊 |
imagePosition 设置裁剪的焦点，遵循与 CSS object-position 相同的规则。因此，房间照片可以侧重 center，而人像照片则侧重 top。如果你想查看完整的适配规则表格，请参见 发布公告图像。
前后对比：最容易见效的方案前后对比：最容易见效的方案
两个插槽，一个分隔符，两个标签。这是最小化的实用拼贴，也是人们最常手动重建的场景：
curl -X POST 'https://render.imejis.io/v1/YOUR_DESIGN_ID' \
-H 'dma-api-key: YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"left": { "image": "https://cdn.example.com/jobs/812/before.jpg" },
"right": { "image": "https://cdn.example.com/jobs/812/after.jpg" },
"left_label": { "text": "March" },
"right_label":{ "text": "August" }
}' \
--output job-812.png由于布局已嵌入设计中，每个任务的对齐方式都完全一致。无论是装修前后、健身进展、旧物修复还是清洁服务，这类问题的本质相同，配置只需三分钟。
拼贴 API 不再适用的场景拼贴 API 不再适用的场景
这一点值得直言不讳，因为它能帮你省下一个浪费的下午。
如果布局需要随照片集合变化，这就不合适了。 设计具有固定的插槽。能够根据 3 张或 11 张照片重新调整网格的软件是另一种产品。在固定设计上实现这种功能，意味着你需要为每种数量创建一个单独的设计。
如果你需要的是编辑照片，而不仅仅是放置。 背景移除、色彩校正、修饰：这些都不在此处进行。请在上游完成这些步骤，然后传入处理好的 URL。
如果只做一张拼贴。 请使用免费制作工具。我们更希望你这样做，而不是为一次性任务接入 API，因为自动化一次性任务纯属兴趣，而非节约。
照片拼贴 API 的成本照片拼贴 API 的成本
每张拼贴图只计一次渲染，不管里面有多少张照片。这个细节值得了解，因为它让成本计算变得很简单：6 张照片的网格和 2 张照片的对拼，费用完全一样。
截至 2026 年 9 月，每月免费渲染 100 次，无需绑卡。一家每月为 40 个项目制作前后对比图的机构，可以一直免费使用。一家房产中介每月为 900 套房源生成挂牌拼贴图，需要 900 次渲染，属于 Basic 套餐，$14.99。定价页面有完整说明，渲染配额文档解释了计数规则。
开始使用开始使用
先在拼贴制作器里调整网格，直到比例满意，然后把它重建为一个设计：每个位置对应一个图片图层，并将每个图层标记为动态。API 文档提供了经过测试的调用示例，动态字段文档说明了每个位置需要开放哪些属性。