PodPSD 合成 API 文档

通过 http 链接上传 PSD 模板。异步受理：接口立即返回模板 sku，系统在后台下载、解析尺寸与智能对象槽位、上传对象存储并生成预览图。

{ "title": "T恤正面", "url": "https://your.com/muban.psd", "type": 5 }

{ "code": 10000, "data": { "sku": "1783579695159834921" }, "msg": "请求成功" }

multipart/form-data 直接上传 PSD 文件（批量导入用）。返回同 /psd/save（含 preview）。

修改模板信息，目前支持自定义标题。

{ "sku": "1712345678901234567", "title": "夏季新款-正面主图" }

（重新）渲染模板缩略预览图并上传对象存储，返回 preview 链接。用于给历史模板补预览。

{ "sku": "1712345678901234567" }

{ "code":10000, "data": { "sku":"...", "preview":"https://.../psd-preview/xxx.jpg" }, "msg":"请求成功" }

列表每项含 preview（预览图直链）与 group_id（所属组，null 表示未分组）。

{ "code":10000, "data": { "list":[ ... ], "totalPage":1, "totalRow":2, "curPage":1 }, "msg":"请求成功" }

{ "sku": "1712345678901234567" }

新建组。

{ "name": "夏季连衣裙-101", "note": "可选备注" }

{ "code":10000, "data": { "id": 12, "name": "夏季连衣裙-101" }, "msg":"请求成功" }

组列表（含每组模板数量 count）。请求体可为空 {}。

{ "code":10000, "data": { "list": [ { "id":12, "name":"夏季连衣裙-101", "count":6, "note":"", "created_at":"..." } ] }, "msg":"请求成功" }

重命名 / 改备注。

{ "id": 12, "name": "夏季连衣裙-101-改", "note": "新备注" }

删除组，组内模板自动转为“未分组”，不会删除模板。

{ "id": 12 }

把一个或多个模板移入组；group_id 传 0 表示移出分组。

{ "group_id": 12, "skus": ["sku1","sku2","sku3"] }

{ "code":10000, "data": { "moved": 3 }, "msg":"已移动" }

multipart/form-data，字段名 files（可多文件，支持整文件夹）。返回 {图层名: URL}，文件名去扩展名即图层名，得到的 URL 可直接填入生成接口 data[].content。仅接受 jpg/jpeg/png/webp。

# 例：上传 sucai3.jpg、sucai4.png
{ "code":10000, "data": { "saved": {
    "sucai3": "https://psd.elmdesk.com/api/pod/material/sucai3.jpg",
    "sucai4": "https://psd.elmdesk.com/api/pod/material/sucai4.png"
  }, "count": 2 }, "msg":"请求成功" }

基于模板 + 图层描述合成图片。合成图上传对象存储后返回图片 sku 与 oss 链接。

路径参数：:订阅sku（/api/shengchengtu/save/:订阅sku）为可选的业务/订阅标识，会原样回写到结果的 typeSku；不需要时用 /api/shengchengtu/save 即可。

data 数组项（图片替换）：

data 数组项（文字替换）：

{
  "psd_sku": "1712345678901234567",
  "data": [
    { "name": "sucai",  "content": "https://your.com/a.jpg" },
    { "name": "sucai2", "content": "https://your.com/b.jpg", "mode": "cover" },
    { "name": "sucai3", "text": "Emely", "font": "https://your.com/font.ttf" }
  ],
  "callback": "https://your.com/cb"
}

同步返回：

{ "code":10000, "data": { "success":1, "msg":"操作成功", "sku":"1712...816",
  "oss":"https://elmdeskpsd.oss-cn-hangzhou.aliyuncs.com/shengchengtu/20260701/xxx.jpg",
  "downUrl":"https://elmdeskpsd.oss-cn-hangzhou.aliyuncs.com/shengchengtu/20260701/xxx.jpg",
  "fileName":"xxx.jpg", "relative":"/xxx.jpg",
  "dpi":300, "fsize":349678, "width":1000, "height":1000 }, "msg":"请求成功" }

纯异步合图：毫秒级受理返回 sku，下载素材/合成/上传在后台队列执行。请求体与 /api/shengchengtu/save 相同（psd_sku、data、callback、mode、forceDown、mediaType），不需要 xFcInvocationType。

{ "code":10000, "data": { "success":1, "sku":"1783579695159834921" }, "msg":"请求成功" }

参数 page / rows / content（搜索 图片sku / psd_sku / 订阅sku）。返回 list / totalPage / totalRow / curPage。