API 對接
透過 URL 查詢參數 picurl，將業務系統中的圖片自動匯入 GenPsd 編輯，為你的系統增加圖片編輯能力。
介面說明
| 參數名 | picurl |
|---|---|
| 取值 | 可公開存取的圖片 URL，URL 必須為 https:// |
| 行為 | 開啟頁面後自動拉取圖片、建立新專案並進入編輯器；成功後網址列會移除 picurl |
| 多語言 |
支援的路徑前綴（ |
方式一：不拼接多語言路徑（自動選擇語言）
使用網站根路徑，首次造訪依系統語言進入對應頁面；若使用者曾切換語言，則優先使用已儲存偏好。
方式二：拼接多語言路徑（指定介面語言）
在路徑中加入 locale 前綴即可固定介面語言。將下方範例的 zh-tw 換成上表任一路徑。
適用場景
- 電商 / 商品系統 — 商品詳情頁「用 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-tw/", "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，註明業務場景、預計呼叫量與目標語言環境，我們會在工作日回覆。