Models 개요
이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.
Sume는 공개 Developer API에서 Job 기반 생성 계열을 제공합니다. 각 계열에는 기본
제품 URL이 있고, 대부분의 계열에는 model-run 별칭도 있습니다. Idempotency-Key와
함께 요청을 제출하고, Job을 폴링한 다음 결과를 읽으세요.
현재 프로덕션 기능은 catalog(GET /v1/catalog)와 OpenAPI
스냅샷으로 확인하세요. 아래 상세 가이드는 프로덕션 OpenAPI 요청
스키마(api.sume.com / 문서 스냅샷)와 일치합니다.
Avatar 1.0
Avatar 1.0은 두 단계 워크플로입니다.
- 재사용 가능한 아바타를 만듭니다.
- 그 아바타로 스크립트나 다중 장면 입력에서 말하는 비디오를 생성합니다.
새 연동에는 정식 제품 라우트를 사용하세요.
| 단계 | 정식 라우트 |
|---|---|
| 아바타 생성 | POST /v1/avatar-1.0/generate |
| 아바타 목록 / 조회 | GET /v1/avatar-1.0/avatars, GET /v1/avatar-1.0/avatars/:id |
| 말하는 비디오 생성 | POST /v1/avatar-1.0/talking-video |
| 비디오 목록 / 조회 | GET /v1/avatar-videos, GET /v1/avatar-videos/:id |
POST /v1/models/sume/avatar/v1.0/runs와
POST /v1/models/sume/avatar-video/v1.0/runs 같은 레거시 model-run 별칭은
호환성을 위해 계속 지원합니다. 자세한 내용은 각 가이드 페이지에 있습니다.
먼저 프롬프트, 레퍼런스 사진, 또는 지원되는 아바타 입력으로 아바타를 만드세요. 아바타 생성은 Job 기반이라 Sume가 Job을 먼저 반환합니다. Job이 끝나면 아바타가 워크스페이스의 재사용 가능한 리소스가 됩니다.
가능하면 고정된 아바타 handle을 사용하세요. 생성된 id에만 의존하는 대신, 앱이나 에이전트가 나중에 재사용할 간단한 이름을 갖게 됩니다.
아바타가 준비되면 스크립트(또는 video_inputs)와 아바타 handle을 보내 아바타
비디오를 만드세요. 각 비디오도 Job 기반입니다. 요청을 제출하고, 폴링하거나 완료를
기다린 다음 결과 URL을 읽습니다.
Avatar Video는 quality: "standard" | "plus" | "max"를 지원합니다. 기본
plus 실행 경로를 쓰려면 생략하세요. 가장 빠른 경로가 필요하면 standard를,
처리 시간보다 품질이 중요하면 max를 사용하세요.
관련 Avatar 유틸리티
| 가이드 | 용도 |
|---|---|
| 아바타 만들기 | 아바타 생성 요청입니다. |
| 아바타 비디오 생성 | 준비된 아바타로 만드는 말하는 비디오입니다. |
| 아바타 비디오 프리뷰 | 전체 렌더 전에 첫 프레임 스틸을 확인한 뒤 generate-video를 호출합니다. |
| 페이스 스왑 (Beta) | 준비된 아바타 얼굴을 공개 소스 비디오에 입힙니다. |
| 비디오 캡션 | 기존 공개 비디오 URL에 캡션을 입힙니다. |
| 비디오 분석 | 기존 공개 비디오 URL을 장면 단위로 이해합니다. |
| 트렌딩 비디오 | 리서치용 TikTok 트렌딩 비디오 메타데이터를 찾습니다. |
Image, Video, Music
관리형 제품 모델입니다. Sume가 프로바이더를 선택하며, 호출자는 프로바이더 모델 id를 보내지 않습니다.
| 계열 | 기본 URL | 가이드 |
|---|---|---|
| Image 1.0 | POST /v1/image-1.0/generate | Image 1.0 |
| Video 1.0 | POST /v1/video-1.0/generate | Video 1.0 |
| Video Router | POST /v1/video-router/generate | Video Router |
| Music 1.0 | POST /v1/music-1.0/generate | Music 1.0 |
Image / Video / Music의 model-run 별칭은
POST /v1/models/sume/<family>/runs를 사용합니다(Request Body는 같습니다).
Video Router는 자체 카탈로그 경로를 씁니다.
특정 카탈로그 모델 id(예: Seedance)가 필요할 때만
Video Router를 쓰고, 그 외에는 Video 1.0 +
routing_preset을 권장합니다.
공통 Job 라이프사이클
이 계열들은 같은 Job 봉투 패턴을 반환합니다.
- 제출 →
job.id,status_url,result_url을 저장합니다. - 상태를 폴링합니다(또는
mode: sync/subscribe로 최대 30초 기다립니다). result_ready가 true가 되면/result를 가져옵니다.- 미디어 Job이라면 Sume가 호스팅하는
artifacts를 읽습니다.
Job과 결과, 생성 접수, 미디어 입력, API 레시피에서 살펴보세요.
프로덕션 OpenAPI보다 앞선 것들
일부 추가 생성기(예: STT)는 프로덕션 OpenAPI 스냅샷에 실리기 전에
api.dev.sume.com에 나타날 수 있습니다. 이런 경로는 문서 OpenAPI 스냅샷과
api.sume.com 레퍼런스에 반영되기 전까지 프로덕션 Developer API 표면으로 다루지
마세요.