AI 제품 사진 API: 스플래시·드립·푸어링 샷

Sume API로 AI 제품 사진을 만들려면 sume-serum-drip이나 sume-toner-pour 같은 카탈로그 이미지 Format 여섯 개 중 하나를 POST /v1/formats/sume/{slug}/runs로 호출하면서 팩샷을 attachments에 넣으세요. 여섯 개 모두 뷰티·스킨케어 제품용으로 작성되었으므로, 그 밖의 제품이라면 POST /v1/images와 input_references로 팩샷을 직접 편집하세요.

아래 내용은 Format 카탈로그 (영문), Format API (영문), 구조화 출력 (영문), Image API (영문) 문서 페이지, 각 Format의 공개 설명, 그리고 Sume API 레퍼런스의 바탕이 되는 OpenAPI 문서에서 가져왔으며, 2026-09-27에 확인했습니다.

어떤 Format이 어떤 샷을 만드나요?

각 설명은 “Not for: animated or motion deliverables”(애니메이션·모션 결과물용 아님)로 끝나므로, 각 Format은 스틸을 돌려줍니다. “accurate packaging”(정확한 패키지) 같은 표현은 Format이 목표로 하는 바를 말할 뿐 보장이 아니므로, 모든 이미지를 실제 제품과 대조해 확인하세요. 카탈로그의 다른 이미지 Format은 제품 세트(sume-editorial-product-set), 모델 포트레이트(sume-model-product-portrait), 매거진 커버(sume-magazine-cover-campaign)를 다룹니다.

제품 샷 Format은 어떻게 호출하나요?

formats:write가 있는 키로, 팩샷을 공개 HTTPS image_url을 담은 input_image 첨부로 보내세요. 이미지를 이름 있는 필드로 돌려받으려면 output_schema를 바인딩하세요. 규칙은 Sume Format 구조화 출력에 있습니다. 문서의 예시는 alt_text 같은 텍스트 필드 옆에 hero_image를 SumeMediaFile#로 바인딩하며, primary_output_key: "hero_image"는 그 이미지를 실행의 primary_output_url로 만듭니다.

• 선언한 모든 속성은 required에 나열해야 하므로, Format이 비워 둘 수 있는 필드는 아래 alt_text처럼 nullable union으로 둡니다. 문서의 규칙은 Format이 실제로 만드는 것만 필수로 요구하라는 것입니다.
• 실행은 202로 응답하고 몇 분이 걸립니다. 실행을 폴링하거나, communication.webhook_url을 설정해 서명된 format.run.terminal POST를 한 번 받으세요.
• 결과 미디어는 내구성 있는 media.sume.com URL이며, URL을 가진 누구에게나 공개됩니다.

curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-serum-drip/runs" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: serum-30ml-drip-v1" \
  -d '{
    "instruction": "Serum-drip hero image of the attached bottle.",
    "attachments": [
      { "type": "input_image", "image_url": "https://example.com/serum-packshot.png" }
    ],
    "output_schema": {
      "name": "acme/serum-hero/v1",
      "strict": true,
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": ["hero_image", "alt_text"],
        "properties": {
          "hero_image": { "$ref": "SumeMediaFile#" },
          "alt_text": { "type": ["string", "null"] }
        }
      }
    },
    "primary_output_key": "hero_image"
  }'

Format 없이 제품 샷을 만들려면 어떻게 하나요?

그 밖의 제품이라면 GET /v1/images/models에서 input_references 디스크립터가 {"min": 0, "max": 0}이 아닌 모델을 골라, 팩샷을 공개 HTTPS URL로 input_references에 담아 POST /v1/images로 보내세요. 팩샷의 형태를 유지하려면 aspect_ratio: "auto"를 쓰는 편이 좋습니다. 모델별 레퍼런스 한도, 크기, 응답 필드는 레퍼런스 이미지 기반 이미지 생성 API에 있습니다.

완성된 샷의 배경을 지우거나 업스케일하려면 어떻게 하나요?

Job으로 실행되는 미디어 도구 두 개가 공개 HTTPS image_url을 받아 Sume에 호스팅된 아티팩트를 돌려줍니다. RMBG 1.0의 스키마는 Format 실행의 primary_output_url 같은 Sume 미디어 URL을 쓰는 편이 좋다고 안내합니다. GET /v1/jobs/:id/status를 폴링한 뒤 GET /v1/jobs/:id/result를 읽으세요. 자세한 내용은 배경 제거 API와 AI 이미지 업스케일러 API에 있습니다.

제품 샷 비용은 얼마이고, 한도는 어떻게 되나요?

Format 실행의 생성은 API 요금의 요율로 계량되고 generation_spend_cap_usd로 상한이 정해집니다. 상한은 최대 $500이고, null이면 $500으로 실행되며, 0은 거부되고, 생략하면 Format의 상한을 물려받습니다. 에이전트 자체의 LLM 턴까지 포함한 실행의 총비용은 usage.debited_usd_micros입니다. 직접 경로에서 이미지 과금은 전부 아니면 전무입니다. 완료된 이미지는 전액 과금되고, 실패한 이미지는 과금되지 않습니다.

• 첨부 파일: JPEG, PNG, WebP, GIF, AVIF 형식에 한 장당 최대 30 MB이며, 실행당 최대 30장, 500 MB입니다.
• Format 실행 안에서는 모델을 고를 수 없습니다. 실행의 model 필드는 오케스트레이션을 맡는 LLM만 고르고, 이미지 모델은 Format의 도구가 고릅니다.