AI 패션 영상 생성 API: 에디토리얼 필름과 룩북

Sume API로 AI 패션 에디토리얼 영상을 만들려면 룩 사진을 첨부하고 스타일링 브리프를 instruction에 넣어 POST /v1/formats/sume/sume-fashion-editorial/runs로 카탈로그 Format sume-fashion-editorial을 실행하세요. 룩북이라면 대량 실행 요청 하나에 룩마다 실행을 하나씩 큐에 넣고, 단계마다 직접 제어하려면 POST /v1/images에서 커버 포즈 스틸을 만든 뒤 POST /v1/videos에서 영상으로 만드세요.

아래 내용은 2026-09-27에 확인한 Sume 문서 Format 카탈로그 (영문), Format 호출하기 (영문), 대량 실행, Image API (영문), 영상 생성 (영문) 페이지에서 가져왔습니다. 특정 의상 한 벌을 사람에게 입히는 것은 다른 작업이며, 가상 착용 영상 API에서 다룹니다.

패션 영상에는 어떤 Sume Format이 맞나요?

카탈로그 Format 설명 가운데 세 개가 “fashion”(패션)이라는 단어를 쓰며, 이들은 작업을 셋으로 나눕니다. 스타일링한 캠페인 필름, 정적인 커버, 그리고 제공된 아이템을 사람에게 입히는 작업입니다. 인용한 문구는 각 Format이 명시한 목표일 뿐, 개별 결과에 대한 보장이 아닙니다.

에디토리얼 필름 한 편의 브리프는 어떻게 쓰나요?

스타일링 컷이나 무드 레퍼런스 같은 룩 이미지를 공개 HTTPS URL을 담은 input_image 항목으로 첨부하세요. 실행당 최대 30장, 장당 30 MB까지입니다. 스타일링은 instruction에 포즈, 세트, 화면 비율, 속도감을 적으세요. instruction은 Format 본문 뒤에 조합되며, 둘이 어긋나면 instruction이 우선합니다. 실행의 model은 오케스트레이션하는 LLM만 고르고, 이미지·영상 모델은 Format의 도구가 고릅니다.

API 실행은 무인 실행입니다. 채팅용 레시피라면 기다렸을 승인은 이미 부여된 것으로 처리되며, 끝낼 수 없는 실행은 failed로 돌아옵니다. 영상을 만드는 실행은 몇 초가 아니라 몇 분이 걸리므로, 결과는 웹훅이나 폴링으로 받으세요.

룩북 전체는 어떻게 만드나요?

POST /v1/formats/sume/sume-fashion-editorial/bulk-runs로 룩마다 실행을 하나씩 큐에 넣으세요. items에는 일반 실행 본문 1–100개가 순서대로 들어가고, 본문마다 자체 instruction과 attachments가 있습니다. concurrency(1–16)는 동시에 진행할 실행 수를 정합니다. 큐에는 웹훅이 없으므로 GET /v1/format-run-queues/{queue_id}를 폴링하거나, 항목마다 communication.webhook_url을 설정하세요. 큐 동작은 Sume Format 대량 실행에서 다룹니다.

curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-fashion-editorial/bulk-runs" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: fall-lookbook-v1" \
  -d '{
    "concurrency": 2,
    "items": [
      {
        "instruction": "Look 1: charcoal coat. 9:16 cover-story film.",
        "attachments": [{ "type": "input_image", "image_url": "https://example.com/look-01.jpg" }],
        "generation_spend_cap_usd": 20
      },
      {
        "instruction": "Look 2: ivory slip dress. 9:16 cover-story film.",
        "attachments": [{ "type": "input_image", "image_url": "https://example.com/look-02.jpg" }],
        "generation_spend_cap_usd": 20
      }
    ]
  }'

에디토리얼 샷을 직접 만들 수 있나요?

네, 호출 두 번이면 됩니다. POST /v1/images에서 커버 포즈 스틸을 만든 뒤, 고른 스틸을 frame_images의 first_frame으로 POST /v1/videos에 보내세요. 이미지 URL은 Sume에 호스팅된 서명된 URL로 돌아오므로, 먼저 스틸을 직접 관리하는 공개 HTTPS URL에 호스팅하세요. 세로 비율은 이미지 모델과 영상 모델이 모두 나열하는 값으로 고르세요. 문서의 seedance-2 항목이라면 3:4나 9:16이 그 예입니다. 문서가 Instagram 세로형(1080×1350)이라고 부르는 4:5는 이미지 전용 비율입니다.

비용은 얼마이고, 어떤 제한이 있나요?

실행별, 큐별로 예산을 잡으세요.

• 각 실행의 생성은 API 요금의 요율로 계량되고, 최대 $500인 그 실행의 generation_spend_cap_usd로 상한이 정해집니다. 대량 실행 요청에서는 항목마다 설정하세요.
• 대량 실행 요청 하나에는 항목을 최대 100개까지 담을 수 있고 동시에 진행되는 것은 최대 16개이며, 모든 자식 실행은 여전히 일반 실행의 접수 검사(지갑, 워크스페이스 생성 동시성, 지출 상한)를 거칩니다.
• 직접 만드는 영상 Job은 제출 시 공급사 정가 × 1.25로 예약되고, 기본 5.5% 에이전트 수수료가 더해집니다.
• Format은 모델을 스스로 고르며, 설명은 목표일 뿐 개별 필름에 대한 약속이 아닙니다.