에이전트
코드에서 Sume 영상 에이전트를 쓰는 글입니다. Agent Completions, 예약 실행, MCP 도구와 타임아웃, 프로그래밍 방식 도구 호출, 유료 API 안전장치를 다룹니다.
먼저 읽을 글 영상 에이전트란 무엇인가요? Sume의 정의와 실행 방식
영상 에이전트 API: 브리프 하나로 편집된 완성 영상 받기
네, 있습니다. 브리프를 편집까지 끝난 완성 영상으로 바꾸는 영상 에이전트 API를 입력, 출력, 가격 단위, 한도와 수정 방식으로 비교하고 Sume가 맞는 경우를 정리합니다.
MCP 서버란 무엇인가요? 쉬운 정의와 예시
MCP 서버는 Model Context Protocol로 AI 앱에 도구, 데이터, 프롬프트 템플릿을 제공하는 프로그램입니다. 동작 방식을 예시와 함께 설명합니다.
원격 MCP 서버 URL: 무엇이고 어디서 찾나요?
원격 MCP 서버 URL은 서버 MCP 엔드포인트의 HTTPS 주소입니다. 어디서 받고 어디에 붙여 넣는지, 왜 열어 보는 페이지가 아닌지 설명합니다.
MCP vs Function Calling(함수 호출): 차이와 함께 쓰는 법
함수 호출(function calling)은 여러분이 정의한 함수의 실행을 모델이 앱에 요청하는 방식이고, MCP는 어떤 클라이언트든 찾을 수 있게 도구를 서버에 둡니다. 둘이 맞물리는 방식을 설명합니다.
MCP vs REST API 차이: 언제 무엇을 써야 하나요?
REST API는 여러분의 코드가 호출하는 엔드포인트이고, MCP는 AI 앱이 실행 중에 서버의 도구를 찾아 호출하게 해 줍니다. 둘의 차이와 각각 언제 쓰는지 정리합니다.
이미지 생성 MCP 서버: Sume generate_image 동작 방식
Sume 호스팅 MCP 서버의 유료 generate_image 도구는 프롬프트를 받으면 수 밀리초 안에 Job id를 반환합니다. 이미지는 jobs_wait와 jobs_result로 받습니다.
ChatGPT 텍스트 음성 변환(TTS): MCP로 오디오 파일 만들기
ChatGPT Voice는 답변을 소리 내어 들려줍니다. 내 대본을 오디오 파일로 받으려면 개발자 모드에서 MCP로 ChatGPT에 텍스트 음성 변환 도구를 추가하세요.
ChatGPT로 영상을 만들 수 있나요? Sora 종료 이후 방법
OpenAI는 2026년에 Sora를 종료했습니다. 그래도 ChatGPT는 개발자 모드에서 원격 MCP 서버의 영상 도구를 호출해 영상 생성을 시작할 수 있습니다.
Claude로 영상을 만들 수 있나요? 영상 도구 호출로만 가능
Claude의 출력은 영상이 아니라 텍스트입니다. 그래도 커넥터로 추가한 Sume 호스팅 MCP 서버 같은 영상 도구를 호출하면 클립을 받을 수 있습니다.
Claude로 이미지를 생성할 수 있나요? 아니요, 도구를 호출합니다
아니요, Anthropic에 따르면 Claude는 이미지를 이해할 뿐 만들거나 편집하지는 못합니다. Sume의 generate_image 같은 이미지 도구를 MCP로 연결하세요.
Claude로 영상을 편집할 수 있나요? 편집 도구 호출로만 가능
Claude는 영상이 아니라 텍스트와 이미지를 입력받고 텍스트로 답합니다. 그래도 MCP로 편집 도구를 호출하면 클립을 자르고, 크롭하고, 조립할 수 있습니다.
영상 생성 MCP 서버: Sume generate_video 동작 방식
Sume 호스팅 MCP 서버에는 유료 generate_video 도구가 있습니다. 프롬프트나 이미지를 넣으면 Job id가 돌아오고, jobs_wait와 jobs_result로 클립을 받습니다.
에이전트 스킬 vs MCP 차이: 각각의 역할과 함께 쓸 때
에이전트 스킬은 작업이 스킬과 맞을 때 에이전트가 읽는 노하우이고, MCP 도구는 에이전트가 서버에서 호출하는 동작입니다. 둘의 차이와 함께 쓰는 경우를 정리했습니다.
휴먼 인 더 루프 AI 에이전트: 사람은 어디서 승인하나요?
휴먼 인 더 루프는 AI 에이전트가 중요한 단계 앞에서 멈추고 사람을 기다리는 방식입니다. Sume 에이전트가 채팅에서 이를 어떻게 하는지, API 실행에서는 무엇이 대신하는지 설명합니다.
Claude 영상 생성 스킬: 지금 가능한 것
Anthropic의 사전 구축 스킬은 영상이 아니라 문서를 다룹니다. Sume CLI 스킬로 Claude Code가 아바타 영상을 만들 수 있고, 다른 클립에는 MCP나 API가 필요합니다.
이미지 편집 MCP 서버: 스타일 변경·배경 제거·업스케일
Sume 호스팅 MCP 서버는 에이전트에게 세 가지 이미지 편집을 제공합니다. 레퍼런스 이미지를 프롬프트로 편집하기, 배경을 제거해 알파 채널 PNG 만들기, 업스케일입니다.
MCP 프롬프트 인젝션: 탈취된 에이전트가 할 수 있는 일 제한하기
MCP 프롬프트 인젝션은 아무도 요청하지 않은 도구를 에이전트가 호출하게 만듭니다. 대신 세션을 제한하세요. 도구는 줄이고, 기본은 읽기 전용으로 두고, 쓰기는 확인을 거치게 하세요.
MCP 서버와 AI 에이전트의 차이는 무엇인가요?
MCP 서버는 도구를 노출하고, 에이전트는 모델이 어떤 도구를 호출할지 정하는 프로그램입니다. Sume의 서버와 에이전트로 일이 어떻게 나뉘는지 봅니다.
YouTube 챕터 생성기: 전사문으로 타임스탬프 만들기
YouTube 챕터 생성기는 전사문을 00:00부터 시작하는 타임스탬프와 제목으로 바꿉니다. 문장 타이밍은 음성 인식에서, 주제가 바뀌는 지점은 LLM에서 얻습니다.
Claude로 오디오를 텍스트로 변환하기: MCP 음성 인식 도구
Claude로 오디오를 텍스트로 전사하려면 MCP로 음성 인식 도구를 연결하고 공개 오디오 URL을 건넨 뒤, 전사문과 단어별 타이밍을 읽으세요.
Claude 텍스트 음성 변환(TTS): MCP로 오디오 파일 만들기
Claude에서 텍스트 음성 변환을 하려면 MCP로 TTS 도구를 연결하세요. Claude가 대본과 음성을 보내고, 오디오 파일 링크를 돌려줍니다.
Claude로 AI UGC 영상 만들기: 아바타, 음성, 립싱크
Claude 모델의 출력은 텍스트입니다. Write를 켜고 Sume 호스팅 MCP 서버를 연결하면 Claude가 UGC 스타일 아바타 클립의 스크립트, 음성, 립싱크를 만들 수 있습니다.
AI 이미지 설명 생성 API: 대체 텍스트와 캡션 만들기
이미지를 볼 수 있는 에이전트 API에 이미지를 보내고, 대체 텍스트, 제목, 상품 설명을 JSON 필드로 요청하세요. Sume로 실행하는 방법을 설명합니다.
AI로 광고 영상 만드는 법: 브리프, 초안, 승인, 재사용
AI로 광고 영상을 만들려면 영상 에이전트에게 결과물을 브리프로 전달하고, 유료 렌더 전에 초안을 검토한 뒤, 레시피를 저장해 재사용하세요.
Claude Code와 Sume MCP로 웹사이트 이미지 생성하기
Claude Code를 Write 권한으로 Sume 호스팅 MCP에 연결하고, dry_run으로 비용을 미리 본 뒤, 사이트 이미지를 생성해 저장소에 저장하세요.
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 에이전트 채팅과 같은 에이전트를 도구·미디어 생성과 함께 실행하고, 폴링하거나 웹훅으로 받는 비동기 실행 영수증을 돌려줍니다.