fal.ai와 Replicate 대안: AI 영상 생성 API 비교
AI 영상 생성에서 fal.ai와 Replicate의 대안인 Kling·Runway API, Higgsfield, Sume를 가격 단위, 모델, API 형태, 한도로 비교합니다.
개발자
Sume API로 개발할 때 필요한 글입니다. API 키와 호스트, 작업과 실행, 폴링, 웹훅, 멱등성, 오류와 요청 한도, SDK, CLI, MCP 인증을 다룹니다.
먼저 읽을 글: Sume API 빠른 시작: 다섯 단계로 첫 영상 생성 호출하기
로컬 vs 원격 MCP 서버 차이: stdio와 Streamable HTTP
로컬 MCP 서버는 여러분의 컴퓨터에서 실행되어 stdio로 통신하고, 원격 MCP 서버는 다른 곳에서 실행되며 Streamable HTTP로 URL에 접속합니다. 고르는 방법을 정리합니다.
MCP SSE vs Streamable HTTP 차이: 무엇을 써야 하나요?
SSE는 지원 중단된 MCP의 이전 HTTP 트랜스포트이고, Streamable HTTP는 모든 메시지를 POST로 받는 단일 엔드포인트로 이를 대체했습니다. 무엇을 고를지 정리합니다.
MCP 도구 vs 리소스 vs 프롬프트: 각각 누가 제어하나요?
MCP 도구는 모델이 호출하고, 리소스는 앱이 첨부하며, 프롬프트는 사용자가 고릅니다. 각각의 용도와 고르는 방법을 정리합니다.
MCP 서버 테스트 방법: Inspector, Postman, curl
MCP 서버는 MCP Inspector로 테스트합니다. 연결하고, 로그인하거나 인증 헤더를 넣고, 도구 목록을 본 뒤 읽기 전용 도구를 호출하세요. Postman과 curl로도 됩니다.
MCP 오류 코드: -32601, -32602, -32001의 의미
MCP 오류 코드는 JSON-RPC 코드입니다. -32700부터 -32603까지의 의미, -32001이 클라이언트 쪽 타임아웃인 이유, 실패한 도구 호출과의 차이를 정리합니다.
Stateless MCP 서버: 세션·Mcp-Session-Id·핸들
Stateless MCP 서버는 요청 사이에 세션을 유지하지 않습니다. Mcp-Session-Id의 역할, 2026-07-28 개정판이 없앤 것, 상태를 대신 어디에 두는지 정리합니다.
MCP JSON 설정 파일: mcp.json 구조와 클라이언트별 차이
MCP JSON 설정은 서버를 이름별로 나열합니다. 로컬 서버에는 명령어를, 원격 서버에는 URL과 헤더를 적습니다. 클라이언트마다 키 이름이 다른 이유도 정리합니다.
MCP 도구 호출 결과 구조: content와 structuredContent
MCP 도구 호출 결과에는 content 배열, 선택 필드 structuredContent, isError가 있습니다. 각 필드의 내용과 이미지 전달 방식, 오류의 모습을 정리합니다.
MCP 도구 설명(description): 쓸 내용과 길이 제한
MCP 도구 설명은 모델이 도구를 고르고 호출할 때 읽는 텍스트입니다. 명세의 규정, Claude Code가 설명을 자르는 지점, 무엇을 써야 하는지 정리합니다.
텍스트로 SRT 자막 파일 만드는 방법: TTS로 타이밍 잡기
SRT 파일에는 줄마다 시작 시각과 끝 시각이 필요합니다. 텍스트를 TTS로 읽히면서 단어별 타이밍을 받고, 타이밍이 붙은 문장마다 번호 블록으로 쓰세요.
Java 음성 인식 API: HttpClient로 오디오를 텍스트로
JDK HttpClient와 Jackson으로 Java에서 음성 인식 API를 호출하세요. 오디오 URL을 POST하고 Job을 폴링한 뒤, 전사문과 단어별 시간을 읽습니다.
401 vs 403 vs 404 차이: API 오류별 의미
401은 자격 증명이 없거나 유효하지 않다는 뜻, 403은 자격 증명으로는 부족하다는 뜻, 404는 리소스가 없거나 숨겨졌다는 뜻입니다. 각각 고치는 법을 알아보세요.
curl Bearer 토큰: Authorization 헤더 보내는 법
curl에서 bearer 토큰은 $TOKEN이 확장되도록 큰따옴표로 감싼 Authorization: Bearer 헤더나 --oauth2-bearer로 보내세요. 401별 해결법도 담았습니다.
400 Bad Request invalid JSON: 원인과 해결법
JSON이 유효하지 않다는 400 Bad Request는 요청 본문이 파싱되지 않았다는 뜻입니다. 셸 따옴표, 작은따옴표, 후행 쉼표, 직렬화하지 않은 객체를 확인하세요.
Retry-After 헤더: 429·503 후 얼마나 기다려야 하나요?
Retry-After는 재시도 전에 얼마나 기다릴지 클라이언트에 알려 주는 헤더로, 초 단위 숫자나 HTTP 날짜이며 429나 503과 함께 옵니다. 읽는 법과 대응 방법을 정리했습니다.
API가 404 Not Found를 반환하는 이유와 해결법
API는 경로나 메서드에 맞는 라우트가 없을 때, 또는 보낸 자격 증명으로는 그 ID가 없을 때 404를 반환합니다. 둘을 구별하고 각각 고치는 법을 알아보세요.
재시도 가능한 HTTP 상태 코드: 어떤 오류를 재시도해야 하나요?
네트워크 오류, 408, 429, 5xx는 백오프하며 재시도하고, 그 밖의 4xx는 대부분 재시도하지 마세요. POST는 멱등성 키가 있을 때만 재시도하고, API의 재시도 플래그를 읽으세요.
429 vs 503 차이: 요청 한도인가요, 서버 과부하인가요?
429는 정해진 시간 동안 요청을 너무 많이 보냈다는 뜻이고, 503은 서버가 지금 요청을 처리할 수 없다는 뜻입니다. 둘 다 Retry-After를 담을 수 있습니다. 대응 방법을 알아보세요.
POST는 멱등한가요? 아니요, PUT과 DELETE는 멱등합니다
아니요, HTTP는 GET, HEAD, OPTIONS, TRACE, PUT, DELETE를 멱등하다고 정의하지만 POST와 PATCH는 아닙니다. 멱등성 키가 있으면 POST 재시도가 안전합니다.
웹훅과 API의 차이는 무엇인가요?
API 호출은 코드가 서버에 무언가를 요청하는 것이고, 웹훅은 어떤 일이 일어났을 때 서버가 내 URL을 호출하는 것입니다. 둘은 함께 동작합니다.
롱 폴링과 숏 폴링의 차이는 무엇인가요?
숏 폴링은 타이머에 맞춰 요청하고 즉시 답을 받습니다. 롱 폴링은 새 소식이 생기거나 타임아웃이 될 때까지 요청을 열어 두었다가 응답을 받으면 다시 요청합니다.
Bearer 토큰과 API 키의 차이는 무엇인가요?
API 키는 자격 증명의 한 종류이고, Bearer는 Authorization 헤더에 자격 증명을 담아 보내는 방식입니다. OAuth 토큰처럼 API 키도 bearer 토큰으로 보낼 수 있습니다.
API 키는 어디에 저장해야 하나요? 서버·CI·로컬 개발
API 키는 서버 쪽에만 두세요. 프로덕션은 시크릿 매니저로 채우는 환경 변수, 파이프라인은 CI의 시크릿 저장소, 노트북은 git이 무시하는 파일에 둡니다.
웹훅 보안 모범 사례: 수신기 체크리스트
HTTPS로만 받고, 원본 본문의 HMAC을 상수 시간으로 검증하고, 오래된 타임스탬프는 거부하고, 이벤트 ID로 중복을 제거하고, 2xx로 빠르게 응답하세요.
HMAC과 디지털 서명의 차이: 웹훅에서 각각 무엇을 증명하나요?
HMAC은 송신자가 공유 시크릿을 가졌음을 증명합니다. 디지털 서명은 개인 키로 만들고 공개 키로 확인하며, 부인 방지까지 더합니다.
cron 표현식 6자리: 맨 앞이 초인가요, 맨 끝이 연도인가요?
표준 cron은 필드가 5개입니다. 6자리 cron 표현식은 맨 앞에 초를 더하거나(Spring, Quartz, Azure Functions) 맨 끝에 연도를 더합니다(AWS).
FFmpeg 영상 자르기: 시간 지정과 재인코딩 여부
FFmpeg에서 영상을 자르려면 -i 앞의 -ss로 탐색하고 -t로 길이를 정하세요. -c copy를 쓰면 재인코딩을 건너뛰지만, 컷이 시작 지점 앞의 키프레임에서 시작합니다.
FFmpeg height not divisible by 2 오류 원인과 해결
yuv420p 인코딩에 홀수 높이(또는 너비)가 들어갔다는 오류입니다. -2로 스케일하거나 trunc(ih/2)*2로 내림해 두 변을 짝수로 만드세요. Sume가 크기를 맞추는 방식도 다룹니다.
yuv420p10le vs yuv420p 차이: 8비트와 10비트 픽셀 포맷
yuv420p와 yuv420p10le는 둘 다 planar YUV 4:2:0입니다. yuv420p는 샘플당 8비트를, yuv420p10le는 10비트를 16비트 워드에 리틀 엔디언으로 저장합니다.
Faststart MP4: moov atom을 파일 앞으로 옮기는 방법
faststart MP4는 인덱스인 moov atom이 파일 앞부분에 있는 MP4입니다. FFmpeg는 -movflags +faststart를 주면 두 번째 패스에서 인덱스를 앞으로 옮깁니다.
FFmpeg로 영상에서 오디오 추출하기: 복사, MP3, WAV
FFmpeg로 영상에서 오디오를 추출하려면 -vn으로 화면을 빼고, -c:a copy로 오디오를 그대로 두거나 인코더로 WAV나 MP3를 쓰세요.
FFmpeg로 영상에서 프레임 추출하기: 한 장, 매초, 전체
FFmpeg로 프레임을 추출할 때 -frames:v 1은 이미지 한 장을, -r 1은 초당 한 장을 저장하고, 번호를 붙인 파일 패턴은 모든 프레임을 씁니다.
FFmpeg로 영상 합치기: concat 디먹서 vs concat 필터
FFmpeg로 영상을 이어 붙일 때 설정이 같은 파일은 concat 디먹서와 -c copy로 재인코딩 없이 잇고, 서로 다른 클립은 concat 필터로 재인코딩해 잇습니다.
FFmpeg로 오디오와 영상 합치기: -map, copy, -shortest
FFmpeg로 오디오와 영상을 합치려면 한 파일에서는 영상을, 다른 파일에서는 오디오를 매핑하고, 영상은 복사하고, -shortest로 길이를 맞추세요.
Text to Image API: 프롬프트 보내고 이미지 URL 받기
Text-to-image API는 HTTPS로 보낸 프롬프트를 생성된 이미지로 바꿉니다. 요청과 응답, 오래 걸리는 Job, 비용까지 호출 방법을 정리했습니다.
AI 이미지 생성은 얼마나 걸리나요?
Sume에서는 대부분의 AI 이미지가 API가 요청을 열어 두는 30초 안에 완성됩니다. 무엇이 시간을 늘리는지, 느린 이미지와 멈춘 이미지를 어떻게 구분하는지 알아보세요.
MCP 도구 어노테이션: readOnlyHint와 클라이언트 활용법
MCP 도구 어노테이션은 readOnlyHint 같은 선택적 힌트입니다. 각 힌트의 의미와 기본값, 그리고 ChatGPT·VS Code·Copilot이 이를 쓰는 방식을 정리합니다.
Claude Code에서 MCP 서버 인증이 필요할 때 해결법
Claude Code는 해결하지 못한 401이나 403을 받은 MCP 서버를 인증 필요로 표시합니다. 다시 로그인하는 방법과 API 키가 더 알맞은 경우를 정리했습니다.
단어 하이라이트 TTS: 단어별 타이밍을 재생에 동기화하기
TTS 재생에 맞춰 단어를 강조하세요. 오디오와 함께 단어별 타임스탬프를 받고, 플레이어의 현재 시간이 시간 범위 안에 드는 단어를 표시합니다.
Python TTS API: 요청, 폴링, MP3 저장하기
Python에서 Requests로 텍스트 음성 변환 API를 호출하세요. 텍스트와 음성을 POST하고 Job을 폴링한 뒤 MP3를 저장하는 Sume TTS 1.0 전체 스크립트입니다.
JavaScript TTS API: Node.js에서 MP3로 저장하기
서버의 JavaScript 코드에서 텍스트 음성 변환(TTS) API를 호출하세요. Node.js에서 Sume SDK로 텍스트를 제출하고, Job을 기다린 뒤 MP3를 저장합니다.
일괄 전사 API: 여러 오디오 파일을 텍스트로 변환하기
API 일괄 전사는 파일마다 음성 인식 Job을 하나씩 보내는 루프입니다. 키는 파일 ID로 만들고, 결과는 웹훅이나 폴링으로 모읍니다. Sume에서 동작하는 방식을 설명합니다.
Python 음성 인식(STT): 오디오를 타임스탬프와 함께 텍스트로
Python에서 Requests로 음성을 텍스트로 변환하세요. 오디오 URL을 보내고 Job을 폴링한 뒤 전사문과 단어별 타임스탬프를 읽는 Sume STT 1.0 스크립트입니다.
JavaScript 음성 인식 API: Node.js에서 오디오를 텍스트로
서버의 JavaScript 코드에서 음성 인식 API를 호출하세요. Node.js에서 Sume SDK로 오디오 파일 URL을 보내고, Job을 기다린 뒤 텍스트를 읽습니다.
AI 영상 생성을 코드로 자동화하는 방법
AI 영상 생성을 자동화하려면 잘 나오는 브리프를 레시피로 저장하고, 이벤트·목록·스케줄에 맞춰 코드에서 시작한 뒤, 완성된 영상은 웹훅으로 받으세요.
202 Accepted와 200 OK의 차이: 작업이 끝났나요?
200 OK는 요청이 성공했고 결과가 담겼다는 뜻이고, 202 Accepted는 작업을 접수했지만 아직 끝나지 않았다는 뜻입니다. 영상 API에서는 본문의 상태를 확인하세요.
415 Unsupported Media Type 오류: 원인과 해결법
415 Unsupported Media Type 오류는 서버가 요청 본문의 형식을 거부했다는 뜻입니다. Content-Type 헤더를 고쳐 JSON은 application/json으로 보내세요.
409 Conflict 오류: 의미와 재시도해야 할 때
409 Conflict는 요청이 서버의 현재 상태와 충돌했다는 뜻입니다. 오류 코드를 읽고 다시 보낼지, Job을 기다릴지, 호출을 고칠지 정하세요.
API 키가 노출됐다면? 먼저 폐기하고 사용 내역 확인하기
노출된 API 키는 폐기하기 전까지 누구나 쓸 수 있습니다. 새 키로 교체하고 이전 키를 폐기한 뒤, 그 키의 최근 사용과 지출, 여러분의 Job을 확인하세요.
여러 사람이 같은 API 키를 써도 되나요?
쓸 수는 있지만, 그러면 키의 요청 한도와 사용 기록, 폐기까지 함께 나누게 됩니다. 사람이나 서비스마다 키를 따로 주고, 그래도 공유되는 것이 무엇인지 알아 두세요.
무료 웹훅 테스터: 코딩 전에 웹훅이 보내는 내용 보기
무료 웹훅 테스터는 공개 HTTPS URL을 주고, 들어온 요청마다 헤더와 본문을 보여 줍니다. Sume의 테스트 보내기(Send test)를 그 URL로 보내면 서명된 페이로드를 볼 수 있습니다.
Python으로 말하는 아바타 만들기: Sume API 활용
Python Requests로 말하는 아바타를 만드세요. 아바타를 생성하고 Job을 폴링한 뒤, 말할 스크립트를 보내고 완성된 영상의 URL을 읽습니다.
AI 이미지 대량 생성 API: 스크립트로 수백 장 만들기
행마다 이미지 요청을 하나씩 보내되, 요청마다 고유한 Idempotency-Key와 async 모드를 쓰고 호출당 최대 네 장을 요청하세요. 속도는 요금제의 동시성이 정합니다.
Python 이미지 생성 API: AI 이미지 생성하고 저장하기
Python에서 Requests로 이미지를 생성하세요. 이미지 API에 프롬프트를 POST하고, 200이면 URL을 읽고 202면 Job을 폴링한 뒤 파일을 하나씩 저장합니다.
Sume API 상태 값 정리: Job, 실행, 큐, 웹훅
Sume API 상태 값을 한곳에 모았습니다. Job, /v1/videos, Format·Agent 실행, 대량 실행 큐, 웹훅 전달, 사용량 행, 공유 권한, 잔액까지 다룹니다.
Sume API 오류 코드 총정리: 표면별 색인과 다음 조치
Sume API 오류 코드를 표면별로 정리했습니다. 공통 코드, 유료 생성, Format, Scheduled 실행, Agent Completions, 미디어 도구, 호스팅 MCP를 다룹니다.
Sume API 페이지네이션: cursor·starting_after·한도
Sume 목록 엔드포인트별 페이지 넘김 방식입니다. Format과 실행 목록은 cursor와 has_more, /v1/jobs는 starting_after를 쓰고, limit만 받는 목록에는 커서가 없습니다.
Sume API 헤더: 인증, 멱등성 키, If-Match, 요청 한도
Sume API가 읽거나 보내는 모든 HTTP 헤더를 정리했습니다. API 키, Content-Type, Idempotency-Key, If-Match, 요청 ID, 요청 한도, 웹훅 서명을 다룹니다.
Sume API 용어집: Format 실행, 지출 상한, 멱등성 키
Sume API 용어를 한두 문장씩 설명합니다. Format, 실행, Job, 지출 상한, 멱등성 키, 지갑, 에이전트 수수료, 웹훅, 아티팩트 등을 관련 글 링크와 함께 정리했습니다.
개발자용 AI 영상 생성 API 추천: 고르는 방법
모든 개발자에게 가장 알맞은 AI 영상 생성 API 하나는 없습니다. 과금 단위, 모델, API 구조, 한도를 비교한 뒤 돌려받을 결과물로 고르세요.
AI 생성 영상 URL은 만료되나요? Sume의 결과물 보관 방식
Format 실행과 Agent Completions에서는 만료되지 않습니다. Sume는 그 미디어를 만료되지 않는 media.sume.com URL로 돌려주며, 링크를 가진 누구나 열 수 있습니다.
Sume API에서 생성한 영상 다운로드하기: 401과 302
Sume의 unsigned_urls는 API 키가 필요하고 302 리다이렉트로 응답합니다. curl -L이나 코드로 MP4를 내려받고, 401, 404, 409를 각각 해결하세요.
웹훅 URL이 유효하지 않다고 거부되나요? Sume 웹훅 URL 규칙
웹훅 URL이 공개 HTTPS가 아니면 Sume는 400 invalid_request로 응답합니다. 스킴, 호스트, 포트, 자격 증명 규칙과 전달 시점의 검사를 정리했습니다.
Sume API 미디어 URL 규칙: 엔드포인트별 허용 URL
Sume 생성 엔드포인트는 공개 HTTPS 미디어 URL을 가져옵니다. 트림, 필터, 프레임, 검사, Timeline은 워크스페이스에 있는 media.sume.com URL만 받습니다.
Sume Job 타입과 동시성: 슬롯을 차지하는 호출
Sume 엔드포인트별 Job 타입과 슬롯 사용 여부입니다. 트림과 Timeline을 포함한 모든 생성 Job은 동시성 슬롯을 차지하고, 프레임과 검사는 차지하지 않습니다.
Sume API 엔드포인트 목록: 경로, 스코프, 멱등성
Sume API의 공개 경로를 계열별로 정리한 색인입니다. 키가 필요 없는 경로, 계열별 스코프, Idempotency-Key 적용 위치, 계열별 설명 글을 담았습니다.
Sume API 출력 파일 형식: MP4·PNG·WebP·WAV·MP3
Sume API 엔드포인트별로 반환하는 파일입니다. Timeline과 편집 도구는 MP4, 이미지는 PNG·JPEG·WebP, 오디오는 WAV나 MP3, 전사문은 JSON입니다.
브라우저에서 Sume API 호출 시 CORS 오류: 해결 방법
브라우저는 내 사이트에서 api.sume.com으로 직접 보내는 호출을 차단하며, API 키는 프론트엔드 코드에 절대 넣으면 안 됩니다. 서버에서 Sume를 호출해 프록시하세요.
Sume MCP 서버 OAuth 플로: 디스커버리·동의·PKCE·스코프
Sume 호스팅 MCP 서버는 자체 OAuth를 운영합니다. 401이 디스커버리 메타데이터를 가리키고, 사용자가 mcp.sume.com에서 동의하면 PKCE S256으로 한 시간짜리 토큰을 받습니다.
Sume MCP insufficient_scope·누락 도구·타임아웃 해결
Sume MCP의 insufficient_scope 오류는 OAuth 세션에 mcp:write가 없다는 뜻입니다. mcp_health부터 호출한 뒤 스코프, 누락된 도구, 타임아웃을 해결하세요.
Sume 에이전트 실행 오류: action_run_in_progress 등
스케줄 실행이 이미 진행 중인데 reject를 보내면 409 action_run_in_progress, ID가 내 Agent Completion 실행이 아니면 404 agent_run_not_found입니다.
CI와 헤드리스 서버에서 Sume CLI 실행하기
CI에서는 버전을 고정한 릴리스 바이너리, 시크릿 저장소의 SUME_API_KEY, 격리된 SUME_CONFIG_DIR, doctor 사전 점검, --json 출력으로 Sume CLI를 실행하세요.
Sume CLI 명령어 레퍼런스: 계정, Job, 에셋, skills
Sume CLI에는 생성 외에도 로그인과 계정, health·doctor 점검, 스키마 탐색, Job, 에셋, 배치 헬퍼, skills, 별칭 명령어가 있습니다.
Sume CLI가 안 될 때: 로그인·API 베이스·Job·미디어 해결법
Sume CLI가 안 될 때는 읽기 전용 점검 네 가지를 먼저 실행한 뒤, 키 누락, 잘못된 API 베이스, 끝나지 않은 Job, 거부된 미디어 URL 중 해당하는 원인을 고치세요.
영상 생성 모델 목록 API: GET /v1/videos/models
GET /v1/videos/models는 Sume의 모든 영상 모델을 해상도, 화면 비율, 길이, 프레임·레퍼런스 유형, 오디오 여부, 가격 SKU와 함께 보여 줍니다.
영상 생성 Job 상태 API 폴링하기: Sume의 /v1/jobs
terminal이 true일 때까지 GET /v1/jobs/{id}/status를 next_poll_after_seconds 간격으로 폴링하고, result_ready가 true면 /result를 읽으세요.
영상 생성 API 동기 vs 비동기: Sume의 네 가지 제출 모드
Sume의 제출 모드는 async, sync, subscribe, webhook입니다. sync와 subscribe는 최대 30초만 기다리므로, 영상은 async로 제출해 폴링하거나 웹훅을 받으세요.
Sume TypeScript SDK 빠른 시작: 설치·클라이언트·오류·재시도
@sume-com/sdk를 설치하고 createSumeClient로 클라이언트 하나를 만든 뒤, throw 대신 오류를 반환하는 타입 지정 오퍼레이션을 호출하세요. 재시도는 기본으로 들어 있습니다.
AI 영상 생성 Job은 왜 실패했나요? Job 오류 읽는 법
실패한 Sume Job에는 category, stage, retryable, public_reason, next_action이 담긴 공개 오류가 있습니다. 읽는 곳과 필드별로 할 일을 설명합니다.
TypeScript SDK에서 Sume Job·실행이 끝날 때까지 기다리기
waitForJob, waitForRun, subscribeFormatRun은 Sume Job이나 실행이 끝날 때까지 폴링합니다. 기본 타임아웃, throw하는 오류, 재시도를 정리했습니다.
Job 목록 API: 상태별 영상 Job 필터링과 잃어버린 ID 복구
GET /v1/jobs는 워크스페이스 Job을 최신순으로 페이지당 100개까지, status·type·run_id로 걸러 나열합니다. starting_after로 넘기고 idempotency_key로 매칭하세요.
Sume API 카탈로그: 사용 가능한 모델·엔드포인트·가격 조회
GET /v1/catalog는 Sume API 기능을 모델 ID, 호출 URL, 가용성, 런타임 준비 상태, 가격과 함께 나열합니다. API 키가 필요 없습니다.
Sume API OpenAPI 스펙: 다운로드·탐색·클라이언트 생성
api.sume.com/reference/json에서 Sume API의 라이브 OpenAPI 스펙을 내려받고, Swagger UI에서 살펴보고, TypeScript 외의 언어용 클라이언트를 생성하세요.
Sume 생성 Job과 Format·Action·Agent 실행의 차이
Sume Job은 /v1/jobs에서 추적하는 생성 요청 하나이고, 실행은 Format, 스케줄, Agent Completion이 시작한 에이전트 턴 하나입니다. ID, 웹훅, 대기 방법이 다릅니다.
Sume 웹훅이 도착하지 않나요? 전달·서명 디버깅 방법
Sume 웹훅이 도착하지 않으면 Job이나 실행의 webhook_delivery를 읽고, 테스트 전송으로 엔드포인트를 확인한 뒤, 실제 이벤트를 다시 보내세요.
AI 영상 생성은 얼마나 걸리나요? Sume Job, 실행, 한도
Sume 문서 기준 영상 Job 하나는 30초에서 몇 분, 롱폼 Format 실행은 15~30분이 걸립니다. 실행 단계와 멈춤 신호, 한도를 정리했습니다.
AI 영상 생성 API 진행 상황 업데이트: 푸시 스트림 없이
Sume에는 SSE나 WebSocket 진행 상황 스트림이 없습니다. Job 이벤트나 Format 실행의 phase 타임라인을 폴링하고, 아바타 장면 스틸을 보여 주되 ETA는 약속하지 마세요.
Sume API로 AI 영상 생성 Job이나 실행을 취소하는 방법
Sume 생성 Job은 생성이 시작되기 전에만 취소되고, Format·Action·Agent 실행 취소는 멱등입니다. 경로, 응답, 과금, 웹훅을 정리했습니다.
영상 생성 API 타임아웃: Sume 대기 상한, SDK 기본값, 만료
Sume의 sync 제출은 최대 30초, SDK 대기는 기본 10–20분을 기다리지만, 클라이언트 타임아웃은 Job을 절대 취소하지 않습니다. 모든 한도와 직접 정할 마감 시간을 정리했습니다.
영상 생성 API 400 오류: 지원되지 않는 파라미터와 해결법
POST /v1/videos 400 원인과 해결: invalid_request, unsupported_parameter(size·seed·provider.options), unsupported_capability.
Sume request_id·job_id·run_id: 저장하고 문의할 ID
Job이나 실행 ID를 저장하고, 웹훅은 job_id나 실행 봉투의 request_id로 중복을 제거하고, Sume 지원팀에는 req_ 요청 ID를 Job이나 실행 ID와 함께 알려 주세요.
Sume API 빠른 시작: 다섯 단계로 첫 영상 생성 호출하기
Sume API 키를 만들고, sume/auto로 POST /v1/videos 요청을 한 번 보낸 뒤, Job을 폴링하고 영상을 내려받으세요. 짧은 다섯 단계와 그다음 갈 곳을 정리했습니다.
Sume 개발자 대시보드: API 키·사용량·Job·결제·플레이그라운드
Sume 개발자 대시보드를 페이지별로 소개합니다. API 키 생성, Billing & subscription에서 크레딧 구매, Jobs·Usage 확인, 플레이그라운드에서 Avatar 시험을 다룹니다.
AI 영상 API 멱등성 키: 이중 과금 없이 재시도하기
멱등성 키를 쓰면 재시도한 생성 요청이 두 번째 유료 작업 대신 원래 실행이나 Job을 돌려줍니다. Sume의 Idempotency-Key가 API별로 어떻게 동작하는지 설명합니다.
무인 AI 에이전트 지출 상한: Sume가 실행별 지출을 제한하는 법
무인 에이전트에는 지출을 승인할 사람이 없어 Sume는 실행마다 생성 비용에 상한을 둡니다. Agent Completions에서는 필수이고, Format 실행은 최대 $500입니다.
영상 API 미디어 입출력: 공개 URL 입력, Sume URL 출력
Sume 생성 요청은 미디어를 정해진 필드의 공개 HTTPS URL로 받으며 별도 업로드 단계가 없습니다. 결과는 저장해 둘 Sume 호스팅 media.sume.com URL로 돌아옵니다.
Sume CLI로 터미널에서 아바타 영상 생성하기
Sume CLI를 설치하고 브라우저로 로그인한 뒤 말하는 아바타 영상을 제출하세요. Image, Video, Music 1.0에는 아직 CLI 제출 명령어가 없습니다.
Sume API 키 동작 방식: 스코프, 인증 헤더, 호스트, 교체
Sume API 키는 워크스페이스 단위 시크릿으로, Bearer나 x-api-key 중 하나로만 보냅니다. 스코프는 생성 시 고정되고, 키는 발급된 호스트에서만 동작합니다.
Sume 영상 Job 동시성과 큐: 한도와 queue_full
Sume는 유효한 유료 Job을 queued로 받아 요금제 동시성 한도 안에서 실행합니다. 제출이 429 queue_full로 실패하는 것은 큐까지 가득 찼을 때뿐입니다.
Sume API 오류와 요청 한도: 오류 코드, 429, 재시도 시점
Sume API 오류는 안정적인 코드와 request id를 담은 하나의 봉투로 옵니다. 읽기와 쓰기는 분당 예산이 따로 있고, queue_full은 요청 한도가 아닙니다.
Sume 영상 실행용 서명된 웹훅: 이벤트, 재시도, 검증
Format·Action·Agent Completion 실행이 완료되거나 실패하면 Sume가 HMAC-SHA256 서명 POST를 한 번 보냅니다. 원본 본문을 검증하고 request_id로 중복을 제거하세요.
Claude Code·Cursor에서 영상과 이미지를 만드는 MCP 서버
Claude Code와 Cursor에서 영상과 이미지를 만드는 MCP 서버 Sume, fal, Replicate, Runway, Higgsfield의 엔드포인트, 로그인, 과금, 설정을 비교합니다.