AI 목업 생성기 API: 제품에 내 디자인 입히기

AI 목업 생성기는 촬영이나 PSD 템플릿 없이 티셔츠, 머그, 상자 같은 제품에 여러분의 디자인을 입힙니다. 이미지 API에서는 아트워크와, 있다면 무지 제품 사진을 레퍼런스 이미지로 보내고, 제품과 디자인이 놓일 위치를 설명한 뒤, 비교할 버전을 몇 개 요청하세요.

Sume에서는 input_references를 여러 개 담은 POST /v1/images 호출 한 번이면 됩니다. 아래 내용은 Image API 문서 (영문)와 GET /v1/images/models가 제공하는 카탈로그에서 가져왔으며, 2026-09-27에 확인했습니다.

내 디자인으로 목업을 어떻게 만드나요?

디자인과 무지 제품을 레퍼런스 두 개로 보내세요. 레퍼런스 항목에는 이미지 URL만 들어가고, 그것이 디자인인지 제품인지 표시하는 필드는 없습니다. 그러므로 프롬프트에서 각 이미지에 무엇이 보이는지 설명해 어느 쪽이 어느 쪽인지 알려 줘야 합니다.

• aspect_ratio는 직접 정하세요. "auto"는 출력을 레퍼런스에 맞추는데, 레퍼런스를 두 개 보내면 어느 쪽을 따르는지 문서에 나와 있지 않습니다.
• 무지 제품 사진이 없다면 디자인만 보내고 제품은 글로 설명하세요.
• 모든 레퍼런스는 공개 HTTPS URL이어야 합니다. localhost, 사설 네트워크, HTTPS가 아닌 URL은 제출 전에 거부됩니다.

curl -X POST "https://api.sume.com/v1/images" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5",
    "prompt": "Print the round fox logo from the artwork image on the plain white ceramic mug from the product photo, centered on the side facing the camera. Keep the shapes and colors of the logo identical. Soft studio light.",
    "aspect_ratio": "1:1",
    "n": 4,
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/fox-logo.png" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/blank-mug.jpg" } }
    ]
  }'

목업 프롬프트에는 무엇을 써야 하나요?

사진가에게 주는 브리프처럼 제품을 설명하고, 제약 조건은 매번 되풀이하세요.

• 제품과 소재: "a heather-gray cotton t-shirt"(헤더 그레이 면 티셔츠), "a matte black water bottle"(무광 검정 물병), "a kraft paper box"(크라프트지 상자).
• 위치와 크기: "centered on the chest, about a third of the shirt's width"(가슴 중앙, 셔츠 폭의 약 삼분의 일).
• 디자인을 입히는 방식: 스크린 인쇄, 자수, 각인, 인쇄된 라벨 중 하나.
• 연출: "flat lay on a wooden table"(나무 테이블 위 플랫레이), "on a hanger against a white wall"(흰 벽 앞 옷걸이에 건 모습), "held in one hand"(한 손에 든 모습).
• 제약 조건: "Keep the artwork's shapes, text, and colors identical."(아트워크의 형태, 글자, 색은 그대로 유지)

요청 한 번에 레퍼런스와 목업을 몇 개까지 다룰 수 있나요?

모델마다 다르며, 호출하기 전에 GET /v1/images/models에서 모델별 범위를 확인할 수 있습니다. 레퍼런스로 편집하는 모델은 다음과 같습니다.

어떤 제한이 있나요?

• 모델은 새 그림을 생성하므로 아트워크의 선, 글자, 색이 달라질 수 있습니다. 목업은 인쇄 교정본이 아니라 미리보기로 다루세요.
• 완료된 이미지마다 모델의 카탈로그 요율에 기본 5.5% 에이전트 수수료가 더해져 과금되므로, 목업 네 장에는 이미지 네 장 값이 듭니다. 실패한 생성은 과금되지 않습니다.
• Image API 결과 URL은 Sume가 호스팅하는 서명된 URL입니다. 보관할 목업은 다운로드하세요.
• 완성된 목업을 더 큰 파일로 만들려면 AI 이미지 업스케일러 API에서 업스케일하는 방법을 확인하세요.
• 여러 제품을 한 장에 담으려면 여러 제품 사진을 이미지 한 장으로 합치기를, 로고에 움직임을 주려면 로고 애니메이션을 참고하세요.