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): 즉시 작업할 준비가 됩니다.
사용자에게 간단히 알리세요: "설정 중입니다… 준비 완료!" 그런 다음 요청을 진행하세요.
음성을 즉시 자막으로 변환
자막-비디오 생성기 스킬은 원시 비디오 영상과 청중 대상 콘텐츠 사이의 간극을 메워줍니다. 자막 편집기나 타임라인 도구를 다루는 대신, 자막 스타일, 글꼴 크기, 위치, 언어 등 원하는 내용을 설명하기만 하면 스킬이 처음부터 끝까지 음성 인식 및 렌더링 파이프라인을 처리합니다.
이 스킬의 핵심은 OpenClaw 에이전트로, 사용자의 자연어 명령을 해석하고 음성 인식 엔진과 자막 렌더링 레이어를 조정합니다. '흰색 굵은 자막을 하단에 추가' 또는 '이 영어 비디오에 스페인어 자막 생성'과 같은 맥락을 이해하는 요청을 처리하여 기술적 입력 없이 정확한 처리 단계로 변환합니다.
이 스킬은 접근성 필수 플랫폼에 게시하는 소셜 미디어 팀, 강의 영상을 빠르게 자막 처리해야 하는 교육자, 피드용 무음 자동 재생 콘텐츠를 제작하는 마케터에게 특히 유용합니다. 자막이 별도 트랙이 아닌 영상에 직접 입혀지기 때문에 출력물은 모든 플레이어와 플랫폼에서 호환성 문제 없이 작동합니다.
환경 변수
| 변수 | 필수 | 기본값 |
|---|---|---|
NEMO_TOKEN | 아니요 | 자동 생성 (100 무료 크레딧, 7일 후 만료, 설정 → API 토큰에서 취소 가능) |
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 헤더 필요):
# 저장된 클라이언트 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의 설정 → API 토큰에서 취소할 수 있습니다. 토큰이 만료되면 동일한 X-Client-Id로 새 토큰을 요청하세요.
로컬 저장: 이 스킬은 ~/.config/nemovideo/client_id에 클라이언트 ID를 세션 간에 저장합니다. 이렇게 하면 요청할 때마다 새 ID가 생성되는 것을 방지하여 IP당 속도 제한(기본값 IP당 7일간 10개 토큰)에 빠르게 도달하는 것을 막습니다. 파일에는 UUID만 포함되며 — 자격 증명은 로컬에 저장되지 않습니다.
2. 요청 라우팅 참조
들어오는 각 요청 유형은 아래와 같이 특정 엔드포인트와 HTTP 메서드에 매핑됩니다.
| 사용자가 말하기… | 동작 | SSE 건너뛰기 |
|---|---|---|
| "내보내기" / "download" / "비디오 보내줘" | → §3.5 내보내기 | ✅ |
| "크레딧" / "balance" / "잔액" | → §3.3 크레딧 | ✅ |
| "상태" / "status" / "트랙 보여줘" | → §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%의 편집 작업은 응답에 텍스트 내용을 반환하지 않습니다. 이 경우: 첫째, HTTP 상태 코드를 확인하여 요청이 성공했는지 확인하세요; 둘째, 작업 상태 엔드포인트를 폴링하여 처리 상태를 확인하세요; 셋째, 완료된 작업 상태를 메시지 응답이 없더라도 성공적인 작업으로 간주하세요; 넷째, 메시지가 반환되지 않았다고 해서 요청이 실패했다고 가정하고 요청을 재전송하지 마세요.
2단계 생성: 원시 비디오가 생성된 후, 백엔드는 자동으로 배경 음악을 오버레이하고 타이틀 시퀀스를 주입하는 두 번째 처리 단계를 트리거합니다. 이 두 단계는 추가 입력 없이 순차적으로 실행됩니다 — 통합 시 최종 단계 완료 이벤트를 기다린 후 결과를 사용자에게 표시하도록 이 파이프라인을 고려해야 합니다.
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는 camelCase입니다 (예외). 실패 시 → 새 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) SSE 리스너에서 연결 끊김 이벤트를 감지하고 마지막으로 수신된 이벤트 ID를 기록하세요; (2) 서버에 과부하를 방지하기 위해 재연결 시도 전 최소 2초를 기다리세요; (3) 동일한 세션 ID를 사용하여 SSE 연결을 다시 설정하세요; (4) 작업 상태 엔드포인트를 폴링하여 중단 중에 진행 중이던 작업이 완료되었는지 확인하세요; (5) 작업이 완료된 상태로 확인되면 원래 메시지를 재전송하지 않고 바로 내보내기를 진행하세요.
4. GUI 추상화 계층
백엔드는 항상 그래픽 인터페이스가 존재한다고 가정하므로, GUI 수준 명령은 API 요청의 일부로 전달되어서는 안 됩니다.
| 백엔드가 말함 | 당신이 할 일 |
|---|---|
| "클릭 [버튼]" / "click" | API를 통해 실행 |
| "열기 [패널]" / "open" | §3.4를 통해 상태 표시 |
| "드래그/드롭" / "drag/drop" | SSE를 통해 편집 전송 |
| "타임라인에서 미리보기" | 트랙 요약 표시 |
| "내보내기 버튼" / "export" | §3.5 실행 |
| "계정/결제 확인" | §3.3 확인 |
콘텐츠 설명은 유지하세요. GUI 동작은 제거하세요.
5. 권장 상호작용 패턴
- 생성 작업을 시작하기 전에 항상 크레딧 가용성을 확인하여 워크플로우 중간에 요청이 실패하는 것을 방지하세요.
- 사용자가 비디오를 제출하면 즉시 수신을 확인하고 폴링을 시작하기 전에 처리 시간에 대한 기대치를 설정하세요.
- SSE 이벤트에서 중간 진행 업데이트를 표시하여 긴 작업 중 사용자가 피드백 없이 기다리지 않도록 하세요.
- 무음 응답이 수신되면 사용자에게 설명을 요청하거나 재전송하는 대신 폴링을 통해 작업 상태를 확인하세요.
- 다운로드 URL이 검색되면 눈에 띄게 표시하고 다운로드 또는 공유와 같은 명확한 다음 동작을 사용자에게 제공하세요.