플랫 레이 API

Photoroom의 플랫 레이 API는 의류 사진을 깔끔한 탑뷰 플랫 레이 이미지로 자동 변환해 온라인 쇼핑몰과 마켓플레이스에서 바로 사용할 수 있게 해줘요. Photoroom API에서 제공하는 20가지가 넘는 편집 중 하나예요.

네. Photoroom API에 의류 사진을 보내고 flatLay.mode를 ai.auto로 설정하면 플랫 레이 이미지를 받을 수 있어요. API를 한 번 호출할 때마다 이미지 한 장을 받을 수 있고, 기본 제한인 분당 60장까지 여러 호출을 병렬로 실행할 수 있어요. 따라서 상품 목록이나 업로드 흐름에 연결하면 새 의류의 플랫 레이 이미지를 자동으로 만들 수 있어요.

Photoroom API에 의류 사진을 보내면 이커머스와 마켓플레이스에 바로 사용할 수 있는 깔끔한 탑뷰 플랫 레이 이미지를 받을 수 있어요. 옷을 직접 연출하고 펼쳐 놓은 뒤 촬영할 필요가 없죠. 요청은 병렬로 처리되며 기본적으로 분당 이미지 60장까지 처리하므로, 상품 목록 전체도 같은 API 호출로 처리할 수 있어요.

의류 카탈로그를 대량으로 운영한다면 Photoroom의 플랫 레이 API가 적합해요. 한 번만 연동하면 각 의류 사진을 플랫 레이 이미지로 만들고, 배경 제거, 고스트 마네킹, AI 다림질 등 20가지가 넘는 편집을 더 이용할 수 있어요. Enterprise 요금제에는 대규모 상품 목록을 위한 더 높은 요청 한도와 결과물 검수 기능이 포함돼요. 영업팀에 문의해 보세요

플랫 레이는 옷을 평평하게 펼쳐 위에서 본 모습으로 보여줘요. 고스트 마네킹은 마네킹 없이 옷을 보여주며 핏과 자연스러운 실루엣을 담아내고, 가상 모델은 옷 사진을 미리 설정된 AI 모델이나 맞춤형 AI 모델을 활용한 라이프스타일 이미지로 바꿔줘요. 세 가지 모두 동일한 Photoroom API를 사용하므로 한 번만 연동하면 모두 이용할 수 있어요.

API 키를 발급받으세요. 그런 다음 flatLay.mode를 ai.auto로 설정해 의류 사진을 보내세요:

curl --request POST \
  --url https://image-api.photoroom.com/v2/edit \
  --header 'x-api-key: YOUR_API_KEY_HERE' \
  --form imageFile=@/path/to/image.png \
  --form flatLay.mode=ai.auto \
  --output result.png

모든 매개변수는 플랫 레이 문서에 나와 있어요.

모든 의류 사진을 동일한 설정으로 같은 Photoroom API 호출을 통해 처리하세요. 변경할 수 있는 설정은 다음과 같아요:

• 플랫 레이를 사용하려면 flatLay.mode를 ai.auto로 설정하세요.

• flatLay.size: 생성된 이미지의 출력 크기와 가로세로 비율이에요. 기본값은 SQUARE_HD예요. 다른 값으로는 PORTRAIT_HD_16_9, PORTRAIT_HD_4_3, PORTRAIT_HD_3_2, LANDSCAPE_HD_3_2, LANDSCAPE_HD_4_3, LANDSCAPE_HD_16_9가 있어요.

• flatLay.prompt: 만들 스타일을 안내하는 선택 입력 프롬프트예요. 예를 들어 깔끔한 스튜디오 플랫레이를 지정할 수 있어요.

최대 30MB이며 가장 긴 변이 5,000픽셀 이하인 PNG, JPEG, WEBP 또는 AVIF 파일을 보내면 같은 형식으로 받아볼 수 있어요. 플랫 레이는 기본적으로 1K(1024 x 1024) 이미지로 결과를 제공하며, Enterprise 요금제에서는 2K와 4K로도 받을 수 있어요. 자세한 내용은 파일 크기, 해상도 및 형식 문서 페이지에서 확인하세요.

플랫 레이는 Plus API 요금제(월 100달러, 이미지당 0.10달러)와 Enterprise 요금제에 포함돼 있어요: 영업팀에 문의하기. API 호출은 건당 0.10달러이며, 필요한 만큼 편집 옵션을 포함할 수 있고 옵션 수는 가격에 영향을 주지 않아요. 오류가 발생한 호출은 이미지 1장으로 계산되지 않아요. 먼저 샌드박스 모드에서 Image Editing API를 테스트해 볼 수 있어요. 매월 워터마크가 표시되는 API 호출 1,000회를 무료로 이용할 수 있어요. 자세한 내용은 요금 페이지에서 확인하세요.

네. Photoroom에는 Flat Lay를 지원하는 Claude와 같은 AI 어시스턴트용 MCP 서버가 있어요. 자세한 내용은 Photoroom MCP에서 확인해 보세요.

API 사용에 어려움이 있으신가요? 엔지니어의 도움을 받으려면 API 커뮤니티에 참여하거나, 자주 발생하는 문제는 문제 해결 페이지에서 확인해 보세요.

결제 관련 문의나 민감한 정보가 포함된 내용은 커뮤니티에서 Photoroom에 직접 DM을 보내 주세요. 언제든 기꺼이 도와드릴게요.