Format 카탈로그

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

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

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

Format이럴 때 사용하세요Page
Product promo제품·브랜드 URL이 있고, 고정된 하우스 스타일의 광고 이미지 또는 프로모 비디오가 필요할 때Product promo
Avatar UGC video스크립트가 있고, 캡션·사운드트랙이 포함된 토킹헤드 크리에이터 스타일 비디오가 필요할 때Avatar UGC video

모든 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뿐입니다.