Claude Code와 Sume MCP로 웹사이트 이미지 생성하기
Claude Code를 Write 권한으로 Sume 호스팅 MCP에 연결하고, dry_run으로 비용을 미리 본 뒤, 사이트 이미지를 생성해 저장소에 저장하세요.
에이전트
코드에서 Sume 영상 에이전트를 쓰는 글입니다. Agent Completions, 예약 실행, MCP 도구와 타임아웃, 프로그래밍 방식 도구 호출, 유료 API 안전장치를 다룹니다.
먼저 읽을 글: 영상 에이전트란 무엇인가요? Sume의 정의와 실행 방식
API로 영상 요약하기: 전사문, 스틸, 그리고 JSON
Sume에 호스팅된 영상을 요약하려면 POST /v1/video-inspect로 스틸과 전사문을 뽑은 뒤, 둘 다 output_schema와 함께 Agent Completions로 보내세요.
Sume란 무엇인가요? 영상 에이전트 플랫폼과 API, 요금
Sume는 영상 에이전트 플랫폼입니다. 채팅에서 에이전트에게 브리프를 주고, 레시피를 Format으로 저장해 백엔드에서 API 하나로 호출합니다. 제품 표면과 요금을 정리했습니다.
Agent Completions·Format·Scheduled 요청 본문 차이
Sume Format·Scheduled 실행과 Agent Completions는 필드 이름만 같고, 지출 상한 기본값, null, on_active_run, attachments, 스코프 규칙은 다릅니다.
on_active_run으로 Sume AI 에이전트 중복 실행 막기
Sume의 on_active_run 필드는 실행 중에 들어온 두 번째 실행 요청의 처리를 정합니다. 그대로 실행하거나, 건너뛴 실행을 기록하거나, 409를 받고 아무것도 실행하지 않습니다.
Sume MCP vs CLI vs API: AI 에이전트는 무엇을 쓸까
Sume에서 AI 에이전트의 주 경로는 HTTP와 Format API입니다. 호스팅 MCP는 원격 MCP 클라이언트에 맞고, CLI는 셸 에이전트에 맞으며 Avatar 중심입니다.
MCP 도구 호출 타임아웃: 긴 영상 Job은 jobs_wait로
Sume 호스팅 MCP 서버에서 jobs_wait 호출 한 번은 최대 55초까지 대기합니다. 긴 영상 Job은 나눠서 기다리고, id는 최대 20개까지 묶되 다시 제출하지 마세요.
Sume MCP 도구 목록: 읽기·쓰기·유료로 나눈 호스팅 도구
Sume MCP 도구를 계열별로 정리했습니다. 읽기만 하는 호스팅 도구, 쓰는 도구, 유료 Job을 시작하는 도구, 호스팅 MCP에 아예 없는 도구 이름을 구분합니다.
MCP 프로그래밍 방식 도구 호출: Sume script_run 동작 방식
script_run은 Sume 호스팅 MCP의 프로그래밍 방식 도구 호출입니다. 짧은 JavaScript 프로그램이 호출 예산과 유료 예산 안에서 도구를 반복하거나 병렬로 호출합니다.
영상 편집 MCP 서버: AI 에이전트로 트림·필터·조립하기
Sume 호스팅 MCP 서버는 AI 에이전트에 영상 편집 도구를 제공합니다. 검사, 프레임, 트림, 필터, 오디오 분리, 합성, Timeline 렌더가 각각 Job으로 실행됩니다.
Sume API로 스케줄 에이전트 실행 목록 조회: 스케줄 점검하기
GET /v1/actions(limit, status, trigger_type)로 Sume 스케줄을 나열하고 각 실행 기록은 커서로 넘기며, cron과 API 실행은 trigger.source로 구분하세요.
이미지 입력·JSON 출력 에이전트 API: Agent Completions
Sume Agent Completions에 이미지를 input_image 파트나 attachments로 보내고, output_schema를 바인딩해 완료된 실행의 output에서 타입 있는 JSON을 읽으세요.
영상 에이전트란 무엇인가요? Sume의 정의와 실행 방식
Sume 문서에서 영상 에이전트는 생성 도구를 조합해 바로 게시할 수 있는 영상을 만드는 샌드박스 에이전트입니다. 채팅으로 브리프를 주거나 HTTP로 호출하세요.
유료 API를 호출하는 AI 에이전트의 안전한 자동화
에이전트는 기본적으로 읽기 전용으로 두고 비밀 값은 로그에서 빼세요. 호스팅 MCP에서는 idempotency_key를 보내고, dry_run으로 미리 보고, max_spend_usd로 상한을 두세요.
AI 영상 에이전트 스케줄 실행: cron, API 트리거, 영수증
Sume 스케줄은 cron 주기로 실행되고 실행 영수증을 돌려주는, 저장된 에이전트 자동화입니다. 대시보드에서 만들고, 실행 시작과 모니터링은 API로 합니다.
Agent Completions로 백엔드에서 Sume 영상 에이전트 실행
POST /v1/agent/completions는 Sume 에이전트 채팅과 같은 에이전트를 도구·미디어 생성과 함께 실행하고, 폴링하거나 웹훅으로 받는 비동기 실행 영수증을 돌려줍니다.