Format 카탈로그

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

Format은 Agent가 실행에 적용하는 저장된 작성 레시피입니다. Sume는 first-party 카탈로그를 제공하므로, 직접 프롬프트를 유지하지 않고 HTTP 한 번으로 프로덕션 워크플로를 만들 수 있습니다.

이 문서는 호출하는 개발자를 위한 페이지입니다. Format이 하는 일, 보낼 파라미터, 결과를 읽는 방법을 살펴봅니다. Format을 작성하는 방법은 다루지 않습니다.

카탈로그는 예약된 sume handle에 있습니다. 지금 호출할 수 있는 slug는 다음과 같습니다:

sume-close-camera-ugc, sume-virtual-try-on, sume-product-usage-demo, sume-mobile-app-ugc, sume-before-after, sume-product-commercial, sume-beauty-studio, sume-logo-motion-design, sume-cinematic-studio-commercial, sume-fashion-editorial, sume-virtual-fitting, sume-water-splash-hero, sume-model-product-portrait, sume-magazine-cover-campaign, sume-formula-texture-hero, sume-sunscreen-splash, sume-cream-squeeze, sume-serum-drip, sume-toner-pour, sume-editorial-product-set, sume-slideshow, sume-wall-of-text, sume-green-screen, sume-video-hook, sume-fruits-drama, sume-recreate, sume-restyle.

호출하기 전에 GET /v1/formats/sume/{slug}로 읽어 보세요. description과 아래에서 설명하는 io 프로필이 돌아옵니다. 이 목록에 없는 slug는 sume/{slug}에서 404 format_not_found를 반환합니다.

모든 Format은 같은 방식으로 동작합니다

카탈로그마다 Format이 아는 것은 다릅니다. 와이어 계약은 같습니다.

  1. 주소를 잡으세요. Formats by Sume는 예약된 sume handle에 있습니다 — POST /v1/formats/sume/{slug}/runs. formats:write를 가진 키라면 누구나 호출할 수 있고, run과 그 미디어, 그 크레딧은 호출한 키에 귀속됩니다. fork도, 설치도 필요 없습니다. Format을 바꾸고 싶을 때만 Format 라이브러리에서 fork하세요 — 사본은 {your_handle}/{slug}로 주소가 지정됩니다.
  2. 호출하세요. instruction과 input으로 POST /v1/formats/{handle}/{slug}/runs를 보냅니다. 202와 receipt가 돌아옵니다.
  3. 폴링하세요. 상태가 종료될 때까지 GET /v1/format-runs/{run_id}를 호출하세요.

API 키에는 formats:read와 formats:write가 필요합니다. Formats 출시 전에 만든 키에는 이 스코프가 없고, 기존 키에 스코프를 추가할 수도 없습니다. API Keys에서 새 키를 만드세요.

모든 Format의 콜 시트

handle와 slug가 있는 Format은 API가 쓰는 주소로 이 사이트에도 페이지가 있습니다.

위 페이지와 같은 섹션(스코프, curl, spend cap, 폴링·취소)을 그 Format 주소로 담습니다. 공유·핸드오프 링크이지 nav가 아니므로 사이드바에는 없습니다. 형식이 맞는 주소면 렌더되며 Format 본문은 절대 보여 주지 않으므로, 파트너에게 넘겨도 호출 방법 이상의 정보는 드러나지 않습니다.

다음으로 갈 곳

직접 작성한 Format도 완전히 같은 방식으로 호출합니다. 카탈로그와의 차이는 주소를 잡는 handle뿐입니다.