跳过主要内容

EzLayers API

把图片分层能力,接入你自己的产品

EzLayers 背后的图层拆分引擎,以 REST API 形式开放。传入一张 PNG 或 JPEG 平面图——可以附上文字描述,也可以框出你想拆出来的对象——每个元素都会成为独立的透明图层,并附带它在画布上的位置。

语义描述或像素框选

用自然语言描述想要的图层,或直接传像素坐标框 [left, top, right, bottom],每个框都会自动拆成独立图层。

背景自动补全

对象原来遮住的部分会被补回来,移动图层不会留下空洞。

拿来就能合成

每层一张透明 PNG,附带它在画布上的位置和叠放顺序——在你自己的流程里还原整张图或生成 PSD,所需信息都在里面。

2–30
每张图的图层数,或自动
描述 + 框选
语义与区域双重控制
PNG + 位置
透明图层及其坐标

传入一张图,拿回可编辑图层

请求

curl https://ezlayers.com/api/v1/separations \  -H "Authorization: Bearer $EZLAYERS_API_KEY" \  -F image=@summer-poster.png \  -F prompt="keep the headline and the logo apart" \  -F 'regions=[[192,96,1376,312],[64,1080,480,1176]]'

然后轮询

curl https://ezlayers.com/api/v1/separations/$ID \  -H "Authorization: Bearer $EZLAYERS_API_KEY"

返回

{  "id": "3f6c1a2e-…",  "status": "succeeded",  "canvas": { "width": 1600, "height": 1200 },  "layers": [    { "name": "background", "zIndex": 0,      "bbox": [0, 0, 1600, 1200], "url": "https://…" },    { "name": "headline", "zIndex": 1,      "bbox": [192, 96, 1376, 312], "url": "https://…" },    { "name": "logo", "zIndex": 2,      "bbox": [64, 1080, 480, 1176], "url": "https://…" }  ]}

任务是异步的:拿返回的 id 轮询,直到 status 变为 succeeded。图层链接 1 小时后失效,重新查询任务即可拿到新链接。

适合谁用

  • 电商与广告素材把广告图和商品横幅拆成图层,每个市场的版本只需改一改,不用重做。
  • 印刷与按需定制客户的作品在进入生产前,先拆成可直接印刷的图层。
  • 设计工具与 SaaS把「一键变可编辑」作为功能提供给你的用户,无需自己训练模型。
  • 代理商与工作室把成批的客户平面素材处理成分层文件,设计师拿来就能用。

怎么开通

  1. 创建 Key登录后打开 设置 → API keys,给每个服务单独建一个,方便单独吊销。
  2. 确定计费API 按实际交付的图层数扣积分,具体单价按账号与你单独确定——联系我们,按你的用量报价。
  3. 调用 API向 /api/v1/separations 提交图片,用返回的 id 轮询,然后下载图层。也可随时通过 GET /api/v1/credits 查询积分余额与单价。

API 常见问题

API 怎么收费?

按积分计费,按实际交付的图层数扣除。任务开始时预扣积分,成功后只按实际返回的结果结算,绝不超过预扣额;失败的任务不扣费。单价按账号与你的用量单独确定:联系我们获取报价,也可以随时用你的 Key 通过 /api/v1/credits 查询。

可以指定拆什么吗?

可以。用 prompt 描述想要的图层,或者传像素坐标框 [[left, top, right, bottom], ...],服务端会自动拼进模型提示词,让每个框成为独立图层。

调用频率有限制吗?

每个 Key 有每分钟请求上限,发起任务、轮询和查询余额都计入。超出后返回 429,并带 Retry-After 头。需要更高额度,告诉我们你的峰值需求即可。

我们上传的图片会怎么处理?

图片在隔离环境中处理,绝不用于训练 AI 模型,API 返回的所有结果都归你所有。数据保留时长可以按你们的数据政策约定。

支持哪些输出格式?

每个图层一张透明 PNG,附带包围框和叠放顺序,你可以在自己的流程里还原整张图或生成分层 PSD。

准备好把图层能力放进你的产品了吗?