영상 생성 MCP 서버: Sume generate_video 동작 방식

영상 생성 MCP 서버는 AI 에이전트에게 프롬프트나 이미지를 영상 클립으로 바꾸는 도구를 제공합니다. https://mcp.sume.com/mcp의 Sume 호스팅 MCP 서버에는 generate_video가 있습니다. 이 도구는 유료 영상 Job을 제출하고, 카탈로그 모델을 지정하지 않으면 sume/auto로 라우팅하며, 에이전트가 jobs_wait로 기다릴 Job id를 반환합니다.

이 계약은 Sume의 MCP 개요, MCP 도구와 게이트, 영상 생성 (영문), Job과 결과 (영문) 문서를 바탕으로 하며, 2026-09-27에 확인했습니다. 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. 호스팅 MCP는 이미 원격 MCP를 지원하는 에이전트에 맞고, 백엔드는 POST /v1/videos를 직접 호출합니다.

에이전트는 어떻게 연결하나요?

원격 MCP 클라이언트가 https://mcp.sume.com/mcp를 가리키게 하세요. OAuth에서 mcp:read 세션에는 읽기 전용 도구만 보이므로 동의 화면에서 Write를 켜세요. mcp:write 세션에는 generate_video 같은 변경·유료 도구가 보입니다. Authorization: Bearer $SUME_API_KEY를 쓰는 API 키 세션에는 전체 호스팅 도구 세트가 보입니다. Claude Code, Cursor, Codex 설정은 Claude Code·Cursor·Codex를 Sume에 연결하기에 있습니다.

generate_video 호출은 어떤 모습인가요?

현재 코드에서 generate_video는 POST /v1/videos에 제출하며, 생성 필드는 모두 idempotency_key 옆의 payload 안에 들어갑니다. 아래 호출은 비용만 미리 봅니다. 제출하려면 dry_run을 빼거나 false로 두고 다시 보내세요.

{
  "idempotency_key": "desk-clip-001",
  "dry_run": true,
  "max_spend_usd": 2,
  "payload": {
    "prompt": "A vertical product clip on a desk, natural light",
    "aspect_ratio": "9:16",
    "duration": 5
  }
}

generate_video는 어떤 payload 필드를 받나요?

필드는 Sume POST /v1/videos 계약을 따릅니다. 한도는 모델마다 다르므로, 모델을 고정하기 전에 video-router_models를 읽으세요.

에이전트는 완성된 클립을 어떻게 받나요?

기다린 다음 읽습니다. 현재 코드에서 generate_video는 수 밀리초 안에 Job id로 응답하며, 클립 URL은 절대 돌려주지 않습니다. Sume 문서에 따르면 영상 생성은 모델과 파라미터에 따라 보통 30초에서 몇 분이 걸립니다.

• 그 id로 호출한 jobs_wait는 호출당 최대 55초(기본값 50초)까지 대기하므로, 클라이언트의 도구 호출 타임아웃은 그보다 길어야 합니다.
• wait_slice_expired를 받으면 같은 id로 jobs_wait를 다시 호출하세요. 유료 create는 절대 다시 제출하지 마세요.
• Job이 종료 상태가 되면 jobs_result가 결과를 반환합니다. Sume는 생성 결과물을 media.sume.com 아래의 Sume 호스팅 아티팩트로 돌려줍니다. 대기 루프는 긴 영상 Job 끝까지 기다리기에서 다룹니다.

Sume generate_video 도구는 무료인가요?

무료가 아닙니다. generate_video는 유료 도구로, 워크스페이스의 USD 잔액에서 청구되고 제출 시점에 예약(선차감)되며, 지출 게이트는 지갑입니다. mcp:paid 스코프는 없으므로 통제는 호출 단위로 이뤄집니다. idempotency_key는 필수이고, dry_run=true는 Job을 제출하지 않고 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 적용됩니다. GET /v1/videos/models는 모델마다 요금을 나열합니다.

이 도구가 하지 않는 일은 무엇인가요?

• sume/auto 뒤에 있는 모델을 알려 주지 않습니다. 응답에는 sume/auto가 그대로 표시되며, Sume는 어떤 모델 계열이 요청을 처리했는지 공개하지 않습니다.
• 클립을 자르거나 조립하지 않습니다. 트림, 필터, Timeline은 별도 도구입니다(영상 편집 MCP 서버).
• 노트북의 파일을 읽을 수 없습니다. 프레임 이미지와 레퍼런스 이미지는 공개 HTTPS로 접근할 수 있어야 합니다.