바로 쓰는 제품 영상 Format: Sume Format 카탈로그
Sume는 제품·UGC 스타일 영상과 이미지를 위한 바로 쓸 수 있는 Format을 제공합니다. 모두 예약된 sume handle에서 HTTP 요청 한 번으로 백엔드에서 호출할 수 있습니다.
Sume는 제품 영상과 제품 이미지를 위한 바로 쓸 수 있는 Format 카탈로그를 제공합니다. 현재 27개가 있습니다. 모두 예약된 sume handle로 호출되므로, 프로덕션 워크플로를 직접 관리하는 프롬프트 대신 HTTP 호출 한 번(POST /v1/formats/sume/{slug}/runs)으로 처리할 수 있습니다.
Format이 처음이라면 Sume Format이란?부터 읽어 보세요. 아래 세부 내용은 Format 카탈로그 문서 (영문)에서 가져왔습니다.
카탈로그에는 어떤 Format이 있나요?
호출하기 전에 GET /v1/formats/sume/{slug}로 먼저 읽어 보세요. description과 선언된 IO 프로필이 돌아옵니다. 카탈로그에 없는 slug는 404 format_not_found를 반환합니다.
| Slug | 이름 | 예시 출력 |
|---|---|---|
sume-close-camera-ugc | Sume Close Camera Ugc(근접 촬영 UGC) | 영상 |
sume-virtual-try-on | Sume Virtual Try On(가상 착용) | 영상 |
sume-product-usage-demo | Sume Product Usage Demo(제품 사용 데모) | 영상 |
sume-mobile-app-ugc | Sume Mobile App Ugc(모바일 앱 UGC) | 영상 |
sume-before-after | Sume Before After(비포 애프터) | 영상 |
sume-product-commercial | Sume Product Commercial(제품 광고) | 영상 |
sume-beauty-studio | Sume Beauty Studio(뷰티 스튜디오) | 영상 |
sume-logo-motion-design | Sume Logo Motion Design(로고 모션 디자인) | 영상 |
sume-cinematic-studio-commercial | Sume Cinematic Studio Commercial(시네마틱 스튜디오 광고) | 영상 |
sume-fashion-editorial | Sume Fashion Editorial(패션 에디토리얼) | 영상 |
sume-virtual-fitting | Sume Virtual Fitting(가상 피팅) | 영상 |
sume-water-splash-hero | Sume Water Splash Hero(워터 스플래시 히어로) | 이미지 |
sume-model-product-portrait | Sume Model Product Portrait(모델 제품 포트레이트) | 이미지 |
sume-magazine-cover-campaign | Sume Magazine Cover Campaign(매거진 커버 캠페인) | 이미지 |
sume-formula-texture-hero | Sume Formula Texture Hero(제형 텍스처 히어로) | 이미지 |
sume-sunscreen-splash | Sume Sunscreen Splash(선크림 스플래시) | 이미지 |
sume-cream-squeeze | Sume Cream Squeeze(크림 짜기) | 이미지 |
sume-serum-drip | Sume Serum Drip(세럼 방울) | 이미지 |
sume-toner-pour | Sume Toner Pour(토너 붓기) | 이미지 |
sume-editorial-product-set | Sume Editorial Product Set(에디토리얼 제품 세트) | 이미지 |
sume-slideshow | Sume Slideshow(슬라이드쇼) | 영상 |
sume-wall-of-text | Sume Wall Of Text(월 오브 텍스트) | 영상 |
sume-green-screen | Sume Green Screen(그린 스크린) | 영상 |
sume-video-hook | Sume Video Hook(영상 훅) | 영상 |
sume-fruits-drama | Sume Fruits Drama(과일 드라마) | 영상 |
sume-recreate | Sume Recreate(다시 만들기) | 영상 |
sume-restyle | Sume Restyle(스타일 바꾸기) | 영상 |
호출하지 않고 Format을 어떻게 고르나요?
GET /v1/formats와 GET /v1/formats/{format_id}는 Format마다 io 프로필을 돌려줍니다. input_kind는 url, text, image, product 중 하나이고, output_kind는 video, image, text 중 하나입니다. 무언가를 호출하기 전에 이 값으로 목록을 걸러 보세요. showcase와 함께 등록된 Format에는 그 Format이 실제로 만든 작업 예시도 담겨 있으며, 이 예시는 Sume의 생성 미디어 원장과 대조해 검증한 것입니다.
등록 절차가 생기기 전에 저장된 Format은 두 필드가 모두 null일 수 있습니다. 이는 “not declared”(선언되지 않음)라는 뜻이지 “takes no input”(입력을 받지 않음)이라는 뜻이 아니므로, 이때는 Format의 description을 참고하세요.
어떻게 호출하나요?
formats:write가 있는 API 키라면 어떤 키로든 카탈로그 Format을 호출할 수 있습니다. 실행과 그 미디어, 지출은 키가 속한 워크스페이스에 귀속되고 카탈로그 Format 자체는 공유된 상태로 남으므로, 먼저 fork하거나 설치할 것이 없습니다.
curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-product-commercial/runs" \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: sku-4411-commercial-v1" \
-d '{
"instruction": "15-second 9:16 commercial for the attached product.",
"attachments": [
{ "type": "input_image", "image_url": "https://cdn.example.com/sku-4411.jpg" }
],
"generation_spend_cap_usd": 20
}'카탈로그 Format을 수정할 수 있나요?
네. Format 라이브러리에서 fork하세요. 사본의 주소는 {your_handle}/{slug}이며, 원본과 똑같은 방식으로 호출합니다.
내 제품에는 어떻게 넣나요?
서버가 Sume API 키 하나를 보관하고 고객을 대신해 Format을 실행하며, 고객이 Sume와 직접 통신하는 일은 없습니다. 제품에 Format 임베드하기 (영문) 쿡북에서 키 보관, 멱등성, 웹훅, 지출 상한, 실패 처리를 다룹니다. `@sume-com/sdk`의 subscribeFormatRun은 호출 한 번으로 실행을 만들고 종료 영수증까지 기다립니다. 프로덕션에서는 웹훅을 권장합니다.
출처
관련 글
작성자 Sume