Sume API: 키 하나로 영상·이미지 모델
open.sume.com의 Sume API는 키 하나로 Seedance, Kling, Veo, Wan 등 영상과 이미지 모델을 돌립니다. 작업을 보내고, 폴링하거나 웹훅을 받습니다.
Sume API는 Sume의 개발자 쪽입니다. open.sume.com의 API 키 하나로 Seedance, Kling, Veo, Wan, GPT Image 등 Sume이 제공하는 모든 영상과 이미지 모델을 돌립니다. 작업을 보내면 바로 id를 받고, 폴링하거나 웹훅을 받습니다. 모델마다 사용량 가격이 있고, 돌리기 전에 가격이 보입니다.
문서는 open.sume.com/docs에 있고, 퀵스타트는 호출 세 번으로 이미지 하나를 만듭니다.
호출은 어떻게 하나요?
open.sume.com에서 키를 만들어 Authorization: Bearer나 x-api-key로 보냅니다. 영상은 https://api.open.sume.com의 POST /v1/video-router/generate로 시작하고, seedance-2.5나 kling-3 같은 모델 id나, Sume이 고르게 하려면 auto를 넣습니다(영상 생성). 이미지는 POST /v1/image-router/generate입니다.
호출은 작업 id와 함께 202 Accepted로 답합니다. 작업을 폴링하거나, mode: "webhook"과 공개 HTTPS webhook_url을 넣으면 작업이 끝날 때 Sume이 결과를 보냅니다(웹훅). Idempotency-Key를 쓰면 재시도가 원래 작업을 돌려줍니다.
| 단계 | 호출 |
|---|---|
| 가격 확인 | POST /v1/open/estimate |
| 영상 시작 | POST /v1/video-router/generate |
| 이미지 시작 | POST /v1/image-router/generate |
| 작업 추적 | 작업 GET, 또는 웹훅 |
비용은 얼마인가요?
모델마다 사용량 가격이 있고 API 요금 페이지에 나와 있습니다. POST /v1/open/estimate는 보내기 전에 정확한 요청의 가격을 알려 주고, 실패한 작업에 잡아 둔 금액은 돌려줍니다.
예전 Developer API는요?
예전 Sume 가이드는 api.sume.com의 Developer API와 /v1/videos, Format 실행, Agent Completions 같은 경로를 다뤘습니다. 새 작업은 위의 Sume API를 쓰세요. 코드 없이 광고를 만들려면 Sume의 에이전트가 앱에서 전부 합니다.
출처
관련 글
개발자 카테고리의 다른 글
- Claude Code·Cursor에서 영상과 이미지를 만드는 MCP 서버
Claude Code와 Cursor에서 영상과 이미지를 만드는 MCP 서버 Sume, fal, Replicate, Runway, Higgsfield의 엔드포인트, 로그인, 과금, 설정을 비교합니다.
- AI 영상 API 멱등성 키: 이중 과금 없이 재시도하기
멱등성 키를 쓰면 재시도한 생성 요청이 두 번째 유료 작업 대신 원래 실행이나 Job을 돌려줍니다. Sume의 Idempotency-Key가 API별로 어떻게 동작하는지 설명합니다.
- Sume 영상 실행용 서명된 웹훅: 이벤트, 재시도, 검증
Format·Action·Agent Completion 실행이 완료되거나 실패하면 Sume가 HMAC-SHA256 서명 POST를 한 번 보냅니다. 원본 본문을 검증하고 request_id로 중복을 제거하세요.
- Sume API 오류와 요청 한도: 오류 코드, 429, 재시도 시점
Sume API 오류는 안정적인 코드와 request id를 담은 하나의 봉투로 옵니다. 읽기와 쓰기는 분당 예산이 따로 있고, queue_full은 요청 한도가 아닙니다.
작성자 Sume