API 对接
通过 URL 查询参数 picurl，把你的业务系统中的图片自动导入 GenPsd 进行编辑，为你的业务系统增加图片编辑能力。
接口说明
| 参数名 | picurl |
|---|---|
| 取值 | 可公网访问的图片URL，URL必须为 https:// |
| 行为 | 打开页面后自动拉取图片、创建新项目并进入编辑器；成功后地址栏会去掉 picurl |
| 多语言 |
支持的路径前缀（ |
方式一：不拼接多语言路径（自动选择语言）
使用站点根路径，首次访问时按系统语言自动进入对应语言页；用户曾在站内切换过语言时，优先使用其保存的偏好。
方式二：拼接多语言路径（指定界面语言）
在路径中写入 locale 前缀，打开即为该语言界面。将下方示例中的 zh-cn 替换为上表任一路径即可。
适用场景
- 电商 / 商品系统 — 商品详情页「用 GenPsd 编辑」跳转，传入主图或场景图 URL。
- 素材 / DAM — 资源库选中资产后，用
picurl打开在线拆层与导出。 - AI 出图 / 工单 — 生成结果 URL 写入对接链接，运营一键进编辑器修图、分层。
- 客服 / 协作 — 用户提交的图片链接由后台拼接到 GenPsd，设计侧直接接手。
对接步骤
- 准备 HTTPS 图片直链（响应为图片文件，非 HTML 页面）。
- 确认图片域名允许浏览器跨域读取（响应头含
Access-Control-Allow-Origin，且允许www.genpsd.com站点或*）。 - 对图片 URL 做
encodeURIComponent编码后，拼到 GenPsd 地址的picurl参数。 - 在新窗口或 iframe 中打开完整链接；用户即可拆层、编辑并导出 PNG / JPG / WEBP / PSD / PPTX。
注意：若图片站未开启 CORS，浏览器会拦截读取，页面将提示「图片暂时打不开」。此时需改为同源代理转发图片，或让用户改用手动上传。
对接案例
案例 1：固定模板跳转
业务侧保存 GenPsd 入口地址，动态替换图片参数：
案例 2：JavaScript 拼接
const imageUrl = "https://cdn.example.com/sku/banner-image.jpg";
const entry = new URL("/zh-cn/", "https://www.genpsd.com");
entry.searchParams.set("picurl", imageUrl);
window.open(entry.href, "_blank", "noopener,noreferrer");
案例 3：HTML 按钮
常见问题
picurl与project同时存在时，优先处理picurl并新建项目。- 仅支持标准图片响应；PDF、网页链接等会导入失败。
- 图层处理在浏览器本地完成，项目默认保存在用户本机 IndexedDB，不经过你的业务服务器。
- 如需咨询接入方案、私有化部署或批量处理能力，请发送邮件至 encoyang@gmail.com，注明业务场景、预计调用量与目标语言环境，我们会在工作日回复。