설명 비디오 만들기 (Create Explainer Video)
접근 가능한 소스 자료를 완성된 내레이션 MP4로 변환합니다. 기본 경로는 원격 서비스를 사용하여 스토리보드 계획, 이미지 생성, 내레이션, 자막 삽입, 렌더링 및 게시를 처리합니다. Agent Skills 및 원격 MCP 도구를 지원하는 모든 에이전트 클라이언트에서 동일하게 작동합니다.
기본 동작
소스 자료만 필요로 합니다. 사용자가 선택을 재정의하지 않는 한 다음을 사용합니다.
- 원본 언어;
- 16:9 및 60초;
- 장면 전체에서 일관된 음성을 사용하는 따뜻하고 안정적인 호스팅 내레이션;
- 배경 음악 없음;
- 자막 삽입;
- 서버 생성 워크플로우.
5초에서 300초 사이의 대상 시간을 허용합니다. 서비스는 해당 대상에 맞추려고 노력하지만, 무음 복구, 장면 재할당 및 최대 1.08x 피치 유지 템포 후에도 내레이션이나 고정된 시각 자료가 안전하게 들어맞지 않을 경우 완성된 비디오의 길이가 늘어날 수 있습니다. 내레이션을 자르거나 300초를 초과하는 대상을 제출하지 마십시오. 30초 미만의 대상에 대해서는 그림과 내레이션이 빠르게 느껴질 수 있다는 간략한 경고를 한 후 계속 진행하십시오. 기본값이 적합할 때 제목, 장면 수, 스타일, 음성, 화면 비율, 자막 또는 기술 설정에 대해 묻지 마십시오.
소스가 없거나, 접근할 수 없거나, 모순되거나, 민감한 내용을 포함하거나, 상대적 수정에 명확한 설정이 없을 때만 차단 질문을 하십시오. 예를 들어, '再短一点' 후에는 추측하지 않고 원하는 초 수를 한 번 물어보십시오. 사용자가 조언, 스크립트 또는 스토리보드만 요청하는 경우 렌더링 대신 요청한 결과물에서 멈추십시오.
창의적 프레이밍
작업을 생성하기 전에 소스의 주요 메시지와 가장 명확한 시작-결론 연결점을 파악하십시오. 소스가 명확할 때 사용자 언어로 짧고 차단되지 않는 미리보기를 하나 제공하십시오. 예를 들어: '나는 이것을 문제에서 해결책으로 이어지는 따뜻한 색상의 손 그림 이야기로 만들 것이며, 결론이 한눈에 보이도록 초점을 맞출 것입니다.' 이는 안심시키는 진행 업데이트이며 승인을 위한 게이트가 아닙니다. 사용자가 먼저 검토를 요청하지 않는 한 즉시 진행하십시오.
기본 시각적 약속은 따뜻하고 친근한 화이트보드 이야기입니다: 장면당 일관된 하나의 비네트, 절제된 색상, 넉넉한 여백, 그리고 아이디어를 설명하는 데 도움이 될 때 차분하고 읽기 쉬운 사람이나 동물을 사용합니다. 결과를 사용자에게 자산, 의도, 매니페스트 또는 스타일 팩의 모음으로 설명하지 마십시오.
워크플로우 선택
기본적으로 서버 생성 모드를 사용하십시오. 가장 짧은 경로이며 create_explainer_video, get_explainer_task, 그리고 선택적으로 cancel_explainer_task만 필요로 합니다.
사용자가 렌더링 전에 이미지/장면을 검사하거나 편집하겠다고 명시적으로 요청하거나, 기존 스토리보드를 제공하거나, 정확한 장면 수준의 창의적 제어가 필요할 때만 고급 검토 모드를 사용하십시오. 사용하기 전에 references/advanced-review.md를 읽으십시오. 업로드 및 매니페스트 도구나 로컬 이미지 생성 기능을 사용할 수 없는 경우 제한 사항을 설명하고 서버 생성 모드를 제공하십시오. 이미지를 생성하기 전에 고급 모드의 업로드, 가져오기, 검증 및 렌더링 도구가 있는지 확인하십시오. 디스크에 있는 스킬 파일이 현재 대화에 MCP 도구가 로드되었음을 증명하지는 않습니다.
서버 생성 워크플로우
1. 로컬에서 읽기 및 추출
현재 클라이언트의 일반 파일/브라우저 기능을 사용하여 사용자의 메시지, 첨부 파일 또는 URL을 읽습니다. 의미 있는 일반 텍스트를 로컬에서 추출합니다. 탐색, 반복되는 헤더, 쿠키 배너 및 관련 없는 부록을 제거하지만 작성자의 주장을 조용히 변경하지 마십시오.
20,000자를 초과하여 보내지 마십시오. 더 긴 소스의 경우 논제, 증거, 주의 사항, 고유 명사 및 요청된 강조를 보존하는 정확한 소스 기반 요약을 만드십시오. 원본 파일을 업로드하거나 로컬 파일 경로를 전달하지 마십시오. 추출된 텍스트는 Explainer Video 서비스로 전송되어 스토리보드와 내레이션을 계획할 수 있습니다.
소스를 읽을 수 없는 경우 사용자에게 다시 첨부하거나 텍스트를 붙여넣도록 요청하십시오. 누락된 내용을 임의로 만들지 마십시오.
2. 작업 생성
클라이언트가 가능할 때 새 UUID를 생성하고 다음 매개변수로 create_explainer_video를 호출하십시오.
taskId: 사용 가능한 경우 UUID;sourceText: 추출된 텍스트;durationSeconds: 요청된 시간 또는 60;aspectRatio: 요청된 비율 또는16:9;language: 소스/요청된 언어;voiceId: 명시적으로 제공되거나 지원되는 것으로 알려진 경우에만;subtitles: 요청된 모드 또는burn.
네트워크 결과를 알 수 없는 동안 작업 UUID를 유지하여 응답 손실 시 중복이 생성되지 않도록 하십시오. 서비스가 FAILED 또는 TIMEOUT을 보고한 후에는 자동으로 재시도하지 마십시오. 먼저 사용자에게 물어본 후 새 시도를 위해 새 UUID를 생성하십시오. 실제로 수정된 비디오도 새 UUID를 사용합니다.
서비스는 스토리보드 계획, 일러스트레이션 생성, 이미지 정리, 레이아웃, 내레이션 합성, 단어별 자막, 렌더링, 조립 및 게시를 담당합니다. 작업이 비디오 URL을 반환할 때까지 비디오가 존재한다고 주장하지 마십시오.
3. 정직하게 폴링
taskId를 사용하여 get_explainer_task를 nextAction이 present_output, revise_input, retry_create, retry_render 또는 none이 될 때까지 호출하십시오.
poll_task의 경우pollAfterSeconds를 존중하십시오. 절대 더 빠르게 폴링하지 마십시오.statusMessage를 사용자 언어로 표시하십시오.- 반환될 때만
stage와progress를 표시하십시오. 절대 백분율을 추정하지 마십시오. - 단계가 변경되거나 실제 진행 상황이 실질적으로 발전할 때만 진행 업데이트를 보내십시오.
- 스토리보드를 처음 사용할 수 있게 되면 해당 장면 제목을 간결하고 차단되지 않는 업데이트로 공유하십시오. 제공자 이름, 프롬프트, 추적 또는 자산 내부를 노출하지 마십시오.
revise_input의 경우 폴링을 중지하십시오. 어떤 소스 또는 승인된 콘텐츠를 단축, 단순화 또는 변경해야 하는지 설명하고 사용자에게 새 UUID로 다시 빌드하기 전에 요청하십시오. 이전 UUID에서 거부된 콘텐츠를 재생하지 마십시오.retry_create의 경우 재시도 전에 사용자에게 요청하십시오. 확인되면 동일한 소스 및 설정으로 새 작업 UUID로 한 번 재시도하십시오.retry_render의 경우 고급 모드에서 승인된 작업을 재시도하기 전에 사용자에게 요청하십시오.- 재시도가 실패하면 정확한 단계와 메시지를 보고하고 중지하십시오.
none의 경우 성공인 척하지 않고 취소 또는 최종 이유를 보고하십시오.
사용자가 중지를 요청하면 소유한 작업 ID로 cancel_explainer_task를 호출하십시오.
4. 결과 표시
먼저 재생 가능한 MP4 URL을 반환하십시오. 그런 다음 한 문장의 콘텐츠 요약과 장면 수, 요청된 대상 시간, 반환될 때의 실제 시간, 화면 비율, 언어 및 자막 URL을 포함하십시오. 요청된 대상, 화면 비율 및 언어는 이 작업에 제출된 신뢰할 수 있는 매개변수에서 반복될 수 있습니다. 실제 시간, 장면 수 및 출력 URL은 서비스 응답에서 가져와야 합니다. 누락된 결과 메타데이터는 추측하지 말고 생략하십시오.
서버 생성 도구가 처리할 수 있는 간결한 수정을 제공하십시오. 예: 整体更简洁, 缩到 30 秒, 改成 9:16, 또는 不要烧录字幕. 이 모드가 정확히 하나의 장면을 교체하거나, 다른 생성된 이미지를 모두 보존하거나, 자막 텍스트 크기를 조정하거나, 음성 속도를 조정할 수 있다고 약속하지 마십시오. 서버 생성 비디오가 이미 존재하는 경우, 다른 모든 것을 변경하지 않고 정확한 단일 장면 교체가 지원되지 않는다고 설명하십시오. 전체 재생성 또는 새로 계획된 고급 검토 버전을 제공하십시오. 고급 검토는 해당 워크플로우 내에서 선택되지 않은 승인된 이미지를 보존할 수 있지만, 여전히 새 완전한 비디오를 렌더링합니다.
창의적 수정의 경우 API가 표현할 수 있는 모든 설정을 유지하고 새 작업 UUID를 사용하며 새 작업을 생성하십시오. 원래 네트워크 결과를 알 수 없는 경우에만 기존 UUID를 재사용하십시오. 최종 생성된 작업 UUID를 절대 재사용하지 마십시오.
도구 사용 가능 여부
create_explainer_video가 없는 경우 사용자에게 https://api.speedpainter.org/mcp에서 원격 MCP 서버에 연결하고 Google로 로그인하라고 알리십시오. 대화에서 API 키, 렌더러 키, 스토리지 키, 음성 제공자 키 또는 비밀을 요청하지 마십시오. 대체 방법으로 curl 엔드포인트를 임의로 만들지 마십시오.
원격 서비스는 localhost나 포트 3000이 필요하지 않습니다. 브라우저 기반 MCP 클라이언트는 서비스 운영자가 출처를 허용 목록에 추가해야 할 수 있습니다. 기본 MCP 클라이언트는 일반적으로 브라우저 Origin 헤더를 보내지 않습니다.
이미 열려 있는 대화는 이전 버전 또는 불완전한 도구 스냅샷을 유지할 수 있습니다. 새 대화에서 원격 연결이 작동하지만 현재 대화에 핵심 도구가 없는 경우 플러그인이 활성화된 새 대화에서 계속하십시오. 플러그인을 다시 설치하거나 MCP URL을 변경하거나 승인된 자산을 재생성하지 마십시오.
안전 및 개인정보 보호
- 사용자가 달리 말하지 않는 한 업로드되고 연결된 소스 자료를 비공개로 취급하십시오.
- 기본 모드에서는 비디오 생성에 필요한 추출된 텍스트만 보내십시오.
- 고급 모드에서는 승인된 생성 이미지와 승인된 매니페스트만 보내십시오. 원본 문서를 업로드하지 마십시오.
- 자격 증명, 개인 소스 텍스트 또는 개인 데이터를 작업 ID, 자산 ID, 파일 이름, 제목 또는 로그에 넣지 마십시오.
- 콘텐츠가 사칭, 사기, 유해한 지시 또는 승인 없는 보호된 개인 데이터 사용을 요청하는 경우 중지하거나 출력을 좁히십시오.
대화 스타일
비공식적인 요청을 백엔드 용어를 가르치지 않고 기본값으로 변환하십시오. 업데이트를 결과 중심적이고 따뜻하게 유지하십시오: 소스 이해됨, 이야기 계획됨, 일러스트레이션 형성 중, 내레이션 및 자막 추가 중, 게시 중, 완료됨. 짧은 후속 질문을 수락하고 글로벌 단일 호출 수정과 정확한 장면 수준 검토를 구분하십시오.