API 연동 - GenPsd 문서

인터페이스

매개변수	`picurl`
값	공개 접근 가능한 이미지 URL. URL은 `https://` 필수
동작	페이지를 열면 이미지를 가져와 새 프로젝트로 편집합니다. 성공 후 주소창에서 `picurl`이 제거됩니다.
다국어	지원 경로 접두사(`locale`): `/zh-cn/` 简体中文、 `/zh-tw/` 繁體中文、 `/ja/` 日本語、 `/ko/` 한국어、 `/en/` English。 루트 `/`도 사용 가능. 브라우저 언어와 `genpsd-locale`로 이동하며 `picurl`은 유지됩니다.

방법 1: 로케일 없음(언어 자동 선택)

사이트 루트를 사용합니다. 첫 방문 시 시스템 언어로 이동하며, 이전에 선택한 언어가 있으면 그 설정을 우선합니다.

방법 2: 로케일 경로(UI 언어 지정)

경로에 locale 접두사를 넣으면 해당 언어 UI로 열립니다. 아래 예시의 ko을 표의 값으로 바꾸세요.

활용 사례

이커머스 — 상품 상세에서 GenPsd 편집으로 이동, 메인/장면 이미지 URL 전달.
자산 / DAM — 선택 자산을 picurl로 열어 레이어 분리·보내기.
AI 생성 / 티켓 — 생성 URL을 연동 링크에 넣어 편집·레이어 작업.
지원 / 협업 — 사용자 이미지 URL을 백엔드에서 GenPsd로 연결.

연동 단계

HTTPS 이미지 직링크 준비(응답은 이미지 파일).
이미지 도메인 CORS 허용(Access-Control-Allow-Origin에 www.genpsd.com 또는 *).
이미지 URL을 encodeURIComponent 후 GenPsd picurl에 연결.
새 창 또는 iframe에서 열면 레이어 분리·편집 후 PNG / JPG / WEBP / PSD / PPTX보내기.

주의: CORS가 없으면 브라우저가 차단합니다. 프록시를 쓰거나 수동 업로드로 전환하세요.

연동 예시

예시 1: 고정 템플릿

비즈니스 측에서 GenPsd URL을 저장하고 이미지 매개변수만 교체:

예시 2: JavaScript

const imageUrl = "https://cdn.example.com/sku/banner-image.jpg";
const entry = new URL("/ko/", "https://www.genpsd.com");
entry.searchParams.set("picurl", imageUrl);
window.open(entry.href, "_blank", "noopener,noreferrer");

예시 3: HTML 버튼

FAQ

picurl과 project가 함께 있으면 picurl을 우선해 새 프로젝트를 만듭니다.
표준 이미지 응답만 지원합니다. PDF·웹 페이지 링크는 실패합니다.
레이어 처리는 브라우저에서 수행되며 프로젝트는 IndexedDB에 저장되어 비즈니스 서버로 가지 않습니다.
연동·온프레미스·배치 처리 문의는 메일로: encoyang@gmail.com 로 업무 시나리오·예상 호출량·언어 환경을 알려주시면 평일에 답변드립니다.