0. 첫 접속
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 환영 인사를 하세요:
🎵 자동 자막 생성기 준비 완료! 비디오를 보내거나 프로젝트를 설명해 주세요.
다음과 같이 말해 보세요:
- "스페인어 자막 추가"
- "영어 자막 추가"
- "자동으로 캡션 생성"
중요: 첫 접속 시 항상 능동적으로 사용자에게 인사하세요. 연결하는 동안 설정 중임을 알리세요. 첫 접속 시 항상 능동적으로 인사하세요.
자동 설정
사용자가 처음 상호작용하면 연결을 설정합니다:
- 토큰 확인:
NEMO_TOKEN환경 변수가 설정되어 있으면 사용합니다. 그렇지 않으면: - 클라이언트 ID 읽기 또는 생성:
~/.config/nemovideo/client_id파일이 존재하면 읽습니다.- 그렇지 않으면 UUID를 생성하여
~/.config/nemovideo/client_id에 저장합니다.
- 익명 토큰 획득:
반환된curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token을 이 세션의NEMO_TOKEN으로 저장합니다. 100개의 무료 크레딧이 제공됩니다. - 세션 생성 (§3.0)하여 즉시 작업할 준비를 합니다.
간단히 "설정 중… 준비 완료!"라고 알린 후 사용자의 요청을 진행합니다.
음성을 즉시 영상에 자막으로 변환
대부분의 자막 도구는 원시 텍스트만 제공하고, 타이밍 조정, 포맷팅, 렌더링 등 어려운 작업은 전적으로 사용자에게 맡깁니다. free-auto-subtitle-generator 스킬은 다른 접근 방식을 취합니다: 사용자가 평범한 언어로 원하는 것을 설명하면 AI가 나머지를 알아서 처리합니다. 하단에 반투명 배경이 있는 흰색 굵은 텍스트를 원하시나요? 그냥 말씀하세요. 소셜 스타일 자막을 위해 두 단어씩 나누길 원하시나요? 대화하듯이 설명하세요.
내부적으로 OpenClaw 에이전트는 먼저 음성-텍스트 변환을 수행하고, 각 단어를 정확한 타임스탬프에 정렬한 다음, 스타일이 적용된 자막을 프레임 단위로 비디오 파일에 렌더링하는 파이프라인을 조율합니다. 타임라인이나 내보내기 설정을 건드릴 필요가 없습니다. 에이전트가 자연어 명령을 해석하여 자동으로 렌더링 매개변수로 변환합니다.
이로 인해 이 스킬은 대량의 짧은 콘텐츠를 제작하는 크리에이터, 강의 녹화에 자막을 추가하는 교사, 접근성 워크플로우를 구축하는 개발자에게 특히 유용합니다. 전체 프로세스가 단일 대화 인터페이스를 통해 실행되므로, 자막 스타일, 언어 또는 위치를 요청을 다시 표현함으로써 반복할 수 있으며, 재업로드나 재구성이 필요 없습니다. mp4, mov, avi, webm, mkv 파일과 완벽하게 호환됩니다.
환경 변수
| 변수 | 필수 | 기본값 |
|---|---|---|
NEMO_TOKEN | 아니오 | 자동 생성 (100 무료 크레딧, 7일 후 만료, Settings → API Tokens에서 취소 가능) |
NEMO_API_URL | 아니오 | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | 아니오 | https://nemovideo.com |
NEMO_CLIENT_ID | 아니오 | 자동 생성 UUID, ~/.config/nemovideo/client_id에 저장 (UUID만, 비밀번호 없음) |
SKILL_SOURCE | 아니오 | 설치 경로에서 자동 감지, 기본값 unknown |
NEMO_TOKEN이 설정되지 않은 경우, 하나를 받으세요 (X-Client-Id 헤더 필요):
# 저장된 Client-Id 생성 또는 읽기
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo && echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
token을 NEMO_TOKEN으로, CLIENT_ID를 NEMO_CLIENT_ID로 저장하세요. 익명: 클라이언트당 7일마다 1개의 토큰; 토큰은 7일 후 만료되며 nemovideo.com의 Settings → API Tokens에서 언제든지 취소할 수 있습니다. 토큰이 만료되면 동일한 X-Client-Id로 새 토큰을 요청하세요.
로컬 저장: 이 스킬은 ~/.config/nemovideo/client_id에 Client-Id를 저장하여 세션 간 지속성을 유지합니다. 이렇게 하면 요청할 때마다 새 ID를 생성하는 것을 방지하여 IP당 속도 제한(기본적으로 IP당 7일간 10개 토큰)을 피할 수 있습니다. 파일에는 UUID만 포함됩니다. 로컬에 저장되는 자격 증명은 없습니다.
2. 올바른 엔드포인트로 요청 라우팅
아래 표를 사용하여 각 유형의 수신 요청을 처리할 엔드포인트를 결정하세요.
| 사용자 말... | 액션 | SSE 건너뛰기 |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 내보내기 | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 크레딧 | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 상태 | ✅ |
| "upload" / "上传" / 사용자가 파일 보냄 | → §3.2 업로드 | ✅ |
| 그 외 모든 것 (생성, 편집, BGM 추가…) | → §3.1 SSE | ❌ |
3. 주요 워크플로우 시퀀스
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
스킬 속성 변수 — 하드코딩하지 마세요:
$SKILL_NAME= 이 파일의 YAML 프론트매터name$SKILL_VERSION= 이 파일의 YAML 프론트매터version$SKILL_SOURCE= 다음 첫 번째 일치 항목을 사용하여 런타임에 감지:- 설정된 경우 환경 변수
SKILL_SOURCE - 이 파일의 경로에 알려진 플랫폼 디렉터리가 포함된 경우 (예:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - 기본값:
unknown
- 설정된 경우 환경 변수
중요: 모든 API 요청(렌더/내보내기/업로드/상태/크레딧 포함)에는 다음 헤더가 포함되어야 합니다. 누락 시 내보내기가 402 오류로 실패합니다.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 세션 초기화
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
다른 모든 작업이 발생하기 전에 서버와 세션이 설정되어야 합니다. 반환된 세션 식별자를 저장하세요. 이후의 모든 요청이 이에 의존합니다.
브라우저에서 열기: 세션 생성 후 사용자에게 NemoVideo에서 작업을 보거나 편집할 수 있는 링크를 제공하세요:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 SSE를 통한 메시지 전달
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
모든 대화 메시지는 지속적인 Server-Sent Events 연결을 통해 백엔드로 전송됩니다.
SSE 처리
| 이벤트 | 액션 |
|---|---|
| 텍스트 응답 | GUI 번역 적용 (§4), 사용자에게 표시 |
| 도구 호출/결과 | 자동 대기, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
타임아웃: 10분 동안 하트비트만 있음 → 타임아웃으로 간주. 생성 중에는 절대 재전송하지 마세요 (중복 + 이중 청구).
이전 응답이 정상이었다면 후행 "일시적인 문제가 발생했습니다" 메시지는 무시하세요.
무음 응답 폴백 (중요)
약 30%의 편집 작업은 응답에 텍스트를 반환하지 않고 완료됩니다. 이 경우: (1) 텍스트 부재를 오류나 실패로 처리하지 마세요, (2) 작업 상태 엔드포인트를 폴링하여 작업이 성공적으로 완료되었는지 확인하세요, (3) SSE 페이로드가 아닌 폴링 결과를 기반으로 사용자에게 완료 메시지를 표시하세요.
2단계 생성: 원시 비디오가 제출되면 백엔드가 자동으로 2단계 강화 파이프라인을 실행합니다. 1단계는 기본 비디오를 처리하고 저장합니다. 2단계는 배경 음악과 자동 생성 제목을 독립적으로 추가합니다. 두 단계 모두 별도의 SSE 이벤트를 내보냅니다. 사용자에게 전체 완료를 보고하기 전에 두 이벤트가 모두 해결될 때까지 기다리세요.
3.2 파일 업로드 처리
파일 업로드: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/path/to/file"
URL 업로드: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
경로에 me를 사용하세요. 백엔드가 토큰에서 사용자를 확인합니다.
지원 형식: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
편집 세션에 첨부해야 하는 비디오 에셋에 대해 직접 파일 업로드가 지원됩니다.
3.3 사용 가능한 크레딧 확인
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
처리 작업을 시작하기 전에 크레딧 엔드포인트를 조회하여 사용자에게 충분한 잔액이 있는지 확인하세요.
3.4 작업 상태 폴링
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
경로에 사용자 me를 사용하세요. 백엔드가 토큰에서 확인합니다.
주요 필드: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
드래프트 필드 매핑: t=트랙, tt=트랙 유형 (0=비디오, 1=오디오, 7=텍스트), sg=세그먼트, d=지속 시간(ms), m=메타데이터.
내보내기 준비 완료된 드래프트는 draft.t가 존재하고 비어 있지 않은 sg를 가진 트랙이 하나 이상 있을 때입니다.
트랙 요약 형식:
타임라인 (3 트랙): 1. 비디오: 도시 타임랩스 (0-10초) 2. BGM: Lo-fi (0-10초, 35%) 3. 제목: "Urban Dreams" (0-3초)
3.5 최종 비디오 내보내기 및 제공
내보내기는 크레딧을 소모하지 않습니다. 생성/편집만 크레딧을 소모합니다.
완성된 비디오를 내보내는 것은 사용자의 잔액에서 크레딧을 차감하지 않습니다. 배송을 완료하려면: (a) 세션 ID로 내보내기 엔드포인트를 호출하고, (b) 내보내기 작업이 최종 상태에 도달할 때까지 기다린 후, (c) 응답 페이로드에서 다운로드 URL을 검색하고, (d) URL에 접근 가능한지 확인한 후, (e) 링크를 표시하거나 사용자를 위해 다운로드를 시작하세요.
b) 제출: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
참고: sessionId는 카멜케이스입니다 (예외). 실패 시 → 새 id, 한 번 재시도.
c) 폴링 (30초마다, 최대 10회): curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
최상위 status 상태: pending → processing → completed / failed. 다운로드 URL은 output.url에 있습니다.
d) output.url에서 다운로드 → 사용자에게 보냅니다. 폴백: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download
e) 비디오를 제공할 때 항상 작업 세부 정보 링크도 함께 제공하세요: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
진행 메시지: 시작 "⏳ 렌더링 중 ~30초" → "⏳ 50%" → "✅ 비디오 준비 완료!" + 파일 + 작업 세부 정보 링크.
3.6 SSE 연결 끊김 복구
SSE 스트림이 예기치 않게 끊어지면 다음 단계에 따라 정상적으로 재개하세요: (1) 스트림 리스너에서 연결 끊김 이벤트를 감지하고 마지막으로 수신된 이벤트 ID를 기록합니다. (2) 재연결을 시도하기 전에 잠시 백오프 간격을 기다립니다. (3) 동일한 세션 ID를 사용하여 SSE 연결을 다시 설정하고 재연결 헤더에 마지막 이벤트 ID를 전달합니다. (4) 작업 상태 엔드포인트를 폴링하여 간격 동안 놓쳤을 수 있는 이벤트를 검색합니다. (5) 폴링된 상태를 로컬 UI 상태와 조정하고 정상적인 이벤트 처리를 재개합니다.
4. 백엔드 응답을 GUI 요소에 매핑
백엔드는 그래픽 인터페이스가 있다고 가정하고 설계되었습니다. 따라서 원시 GUI 명령어나 UI 지시를 최종 사용자에게 절대 전달하지 마세요.
| 백엔드가 말함 | 당신이 할 일 |
|---|---|
| "click [button]" / "点击" | API를 통해 실행 |
| "open [panel]" / "打开" | §3.4를 통해 상태 표시 |
| "drag/drop" / "拖拽" | SSE를 통해 편집 전송 |
| "preview in timeline" | 트랙 요약 표시 |
| "Export button" / "导出" | §3.5 실행 |
| "check account/billing" | §3.3 확인 |
콘텐츠 설명은 유지하세요. GUI 액션은 제거하세요.
5. 권장 상호작용 패턴
• 내보내기나 파괴적 편집과 같은 되돌릴 수 없는 작업을 실행하기 전에 사용자의 의도를 확인하세요. • 장기 실행 작업을 제출한 후에는 자동으로 사용자에게 처리 중임을 알리고 조용히 기다리지 마세요. • 무음 응답이 감지되면 폴링된 작업 데이터를 사용하여 아무것도 보고하지 않는 대신 의미 있는 상태 업데이트를 구성하세요. • 크레딧 확인이 실패하면 부족분을 명확히 설명하고 재시도 전에 해결 방법을 안내하세요. • 항상 최종 다운로드 URL을 별개의 실행 가능한 링크로 제시하세요.