영상 에이전트란 무엇인가요? Sume의 정의와 실행 방식

Sume 문서에서 영상 에이전트는 개별 생성 도구(Image, Video, Avatar, TTS, timeline 등)를 조합해 바로 게시할 수 있는 영상을 만드는 샌드박스 에이전트입니다. 사용자가 결과물을 설명하면 에이전트가 모델을 고르고, 비용을 쓰기 전에 먼저 묻고, 결과를 조립하므로 원시 모델 호출을 직접 이어 붙일 필요가 없습니다.

이 글은 이 용어를 Sume 문서가 쓰는 뜻으로만 정의하며, Sume 기초에서 출발합니다. 이 페이지는 Sume를 “fundamentally a video agent platform.”(본질적으로 영상 에이전트 플랫폼)이라고 부릅니다.

모델 호출 한 번과 달리 영상 에이전트는 무엇을 만들 수 있나요?

문서의 답은 조합입니다. 에이전트가 도구를 조합하므로, 생성된 클립 하나로는 낼 수 없는 결과물을 내놓을 수 있습니다. 수 분짜리 호스트 영상, B-roll, 보이스오버, 그리고 이것들을 바로 게시할 수 있는 영상으로 엮는 타임라인 조립이 그 예입니다.

개별 모델도 원자적 HTTP 엔드포인트로 여전히 존재합니다. 아바타 만들기, 말하는 클립 렌더링, 이미지나 짧은 영상 클립 생성, 자막 추가 같은 것입니다. 문서는 이들을 Format에 비해 보조 역할을 하는 구성 요소로 설명합니다. 어떤 도구를 어떤 순서로 호출하고 결과를 어떻게 조립할지는 Format이 정합니다. 클립이나 이미지 하나만 필요하면 모델을 호출하고, 패키지된 워크플로가 필요하면 Format을 호출하세요.

Sume의 영상 에이전트와는 어떻게 작업하나요?

에이전트 채팅에서는 사람이 샌드박스 에이전트와 함께 작업합니다. 브리프를 쓰고, 지출을 승인하고, 아티팩트를 확인하며, 몇 턴에 걸쳐 하우스 스타일을 다듬습니다. 스레드에는 모든 아티팩트와 승인 기록이 남습니다. 사람이 루프에 남아야 할 때는 대화형 채팅이 맞는 표면입니다.

도구 호출이 아니라 결과물을 설명하세요. 다음은 빠른 시작에 나오는 예시 브리프입니다.

Make a 15-second vertical product promo with a presenter avatar and captions.
Show me a draft before the final render.

영상 에이전트는 어떻게 API 호출이 되나요?

레시피를 저장하면 됩니다. 에이전트에게 “이걸 product-promo라는 Format으로 저장해 줘”라고 요청하거나, 라이브러리에서 Format을 편집하세요. Format은 handle과 slug로 호출할 수 있는, 저장된 작성 레시피(SKILL.md와 참고 파일)입니다. 파트너가 Format을 호출하면 Sume는 새 샌드박스를 띄우고, 레시피를 로드하고, 생성 도구를 쓰는 에이전트를 실행한 뒤, 아티팩트와 선택적 구조화 JSON을 돌려줍니다. 문서는 Format API를 대부분의 파트너가 연동해야 하는 표면이라고 설명합니다.

백엔드는 formats:read와 formats:write 스코프가 있는 키를 써서, Idempotency-Key 헤더와 함께 POST https://api.sume.com/v1/formats/{handle}/{slug}/runs를 보냅니다. 호출은 실행 영수증과 함께 202를 반환합니다. 실행이 queued나 processing을 벗어날 때까지 status_url을 폴링한 뒤 result_url을 읽으세요. 자세한 내용은 Sume Format이란?에 있습니다.

Format run = fresh sandbox + recipe (SKILL) + instruction/input + tools
           → artifacts + optional structured output

어떤 작업에 어떤 Sume 표면이 에이전트를 실행하나요?

모델 엔드포인트를 제외한 모든 표면이 에이전트를 실행합니다. Agent Completions는 임시 작업용이고 Scheduled는 반복 작업용이며, 레시피가 고정되고 입력만 바뀔 때는 여전히 Format이 맞는 경로입니다.

무인으로 실행되는 영상 에이전트는 어떻게 통제하나요?

모범 사례 페이지와 기초 페이지는 Format과 Agent Completions를 호출할 때 다음 규칙을 제시합니다.

• 모든 실행에 지출 상한을 두세요. generation_spend_cap_usd는 항상 설정하고, 해당하면 에이전트 상한도 설정하세요. 상한이 빠진 호출은 클라이언트 버그로 취급하세요.
• 저장된 레시피가 있으면 원시 모델 호출보다 Format을 우선하세요. 도구, 지출 게이트, 하우스 스타일은 Format이 맡고, 클라이언트는 브리프만 보냅니다.
• 다른 서비스가 결과를 읽는다면 output_schema를 바인딩하고, Format이 실제로 만드는 필드만 필수로 두세요.
• 자격 증명은 범위를 좁게 유지하세요. 팀 handle의 Format에는 팀 API 키를 쓰고, 클라이언트에 필요한 가장 좁은 스코프만 주고, 키는 대시보드에서 교체하세요.
• 워크스페이스는 키가 알려 주게 하세요. 요청 본문에 workspace_id를 보내지 마세요.

다른 에이전트도 Sume 도구를 쓸 수 있나요?

네. Sume 개발자 도구는 하나의 경계를 공유합니다. 공개 API가 원본이고, 래퍼는 얇게 유지합니다. 워크스페이스 범위의 Developer API 외에도 셸과 스크립트를 위한 CLI, 원격 MCP 클라이언트를 위한 https://mcp.sume.com/mcp의 호스팅 MCP, 대시보드 도구가 있습니다. 기초 페이지는 CLI와 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다.

문서는 에이전트 도구가 쓰기나 유료 작업의 확인을 요청하기 전에 계획 단계에서 카탈로그, Job, 미디어 스키마, 사용량 읽기를 활용하고, 사용자에게 워크스페이스 id를 묻지 말라고 요구합니다. 그 컨텍스트는 API 키나 인증된 앱 세션에서 옵니다.