AI 보정 API

Photoroom의 AI 뷰티파이어 API는 제품 사진이나 음식 사진의 주요 피사체를 더 보기 좋게 다듬어 품질을 높여요. 사진 한 장부터 전체 상품 목록까지 처리할 수 있어요.

일반적인 이미지 필터와 달리, 판매하는 제품에 맞춘 모드가 있어요. ai.auto는 감각적인 제품 사진 스타일로, ai.food는 음식에, ai.car는 자동차에 맞는 결과를 만들어줘요. Photoroom API에서 제공하는 20개가 넘는 편집 중 하나예요.

Photoroom의 AI 보정 API는 판매자가 사진을 업로드하는 과정에서 바로 작동해요. 판매자가 사진을 촬영하거나 업로드하는 방식을 바꾸지 않아도, 사진이 업로드되는 대로 보정해 드려요. API는 요청당 이미지 한 장을 처리하며, 요청 한도 내에서 여러 요청을 동시에 처리할 수 있어요. 기본 한도는 분당 이미지 60장이고, Enterprise에서는 더 높아요.

같은 요청에서 위치 조정, AI 그림자 또는 AI 배경과 함께 사용할 수 있어요.

음식 이미지에는 Photoroom의 AI Beautifier API 전용 음식 모드가 있어요. beautify.mode를 ai.food로 설정하면 음식 이미지의 특성에 맞춘 결과를 얻을 수 있어요. 예를 들어 음식이 접시 위에 놓이도록 해줘요.

음식 배달 플랫폼과 식료품 앱은 이를 통해 메뉴나 상품 목록 전체를 전송할 수 있어요. 호출당 이미지 한 장씩 전송하고, 속도 제한에 도달할 때까지 여러 호출을 병렬로 실행할 수 있어요.

그런 경우에는 AI Beautifier가 아니라 Photoroom의 비주얼 QA를 살펴보세요. AI Beautifier는 사진을 개선해 주지만 점수를 매기거나 걸러내지는 않아요. 비주얼 QA는 Enterprise 요금제에서 이용할 수 있으며, 독립형 API 제품으로도 판매돼요.

Enterprise 요금제에서는 Visual Agents 워크플로에서 비주얼 QA와 AI Beautifier, 그 밖의 편집을 함께 활용할 수 있어요. 설정하려면 영업팀에 문의해 보세요.

AI Beautifier는 월 100달러(이미지당 0.10달러)인 Plus API 요금제와 Enterprise 요금제에 포함되어 있어요. 한 번 호출할 때 함께 적용하는 편집 항목 수와 관계없이 비용은 같아요. 따라서 한 번의 호출로 이미지를 보정하고 그림자를 추가해도 보정만 할 때와 비용이 같고, 오류가 반환된 호출은 이미지 1장으로 계산되지 않아요.

먼저 샌드박스 모드에서 이미지 편집 API를 테스트해 볼 수 있어요. 매월 워터마크가 표시되는 API 호출 1,000회를 무료로 이용할 수 있어요. Enterprise 요금제를 이용하려면 영업팀에 문의하세요. 자세한 내용은 요금 페이지에서 확인하세요.

API 키를 발급받으세요. 그런 다음 사진을 beautify.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 beautify.mode=ai.auto \
  --output result-ai-beautifier.png

음식 사진에는 beautify.mode=ai.food를 사용하세요. 모든 매개변수는 AI Beautifier 문서에서 확인할 수 있어요.

• beautify.mode (필수): ai.auto는 세련된 제품 팩샷 스타일을 따르는 결과를, ai.food는 음식 이미지를, ai.car는 자동차 이미지를 위한 모드예요. 예를 들어 원치 않는 반사를 제거할 수 있어요.

• beautify.seed(선택 사항): 양의 정수입니다. 시드를 고정하면 API가 같은 이미지에서 비슷한 모습으로 보정된 피사체를 반환해요. 시드를 지정하지 않으면 호출할 때마다 결과가 달라져요.

AI Beautifier는 주요 피사체를 새롭게 표현한 이미지로 만들기 때문에 일부가 달라질 수 있어요. 결과를 원본과 비교해 보고, 예시는 문서에서 확인해 보세요.

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

네. Photoroom에는 Claude와 같은 AI 어시스턴트를 위한 MCP 서버가 있어요. 제공하는 도구는 Photoroom MCP에서 확인해 보세요.

AI Beautifier를 자체 제품에 통합하려면 Claude Code 같은 AI 코딩 에이전트를 활용해 Photoroom API를 빠르게 연동할 수 있어요. 원하는 결과를 설명하면 에이전트가 코드를 작성하고 실행하고 디버깅해 줘요. 문서에는 바로 사용할 수 있는 프롬프트가 있어요.

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

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