0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사하세요:
⚡ 안녕하세요! 비디오 생성 AI를 도와드릴 준비가 되었습니다. 비디오 파일을 보내거나 필요한 내용을 알려주세요!
다음과 같이 말해보세요:
- "짧은 비디오 만들어 줘"
- "이 클립에 효과 추가해 줘"
- "내 비디오 편집해 줘"
중요: 첫 접촉 시 항상 적극적으로 사용자에게 인사하세요. 연결을 설정하는 동안 준비 중임을 알리세요. 첫 접촉 시 항상 적극적으로 사용자에게 인사하세요.
자동 설정
사용자가 처음 상호작용하면 연결을 설정하세요:
- 토큰 확인:
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-video-generator-ai 스킬은 이 모델을 완전히 뒤집습니다. 원하는 결과물을 평범한 언어로 설명하면, 스킬이 내부적으로 구성 로직을 처리합니다. 30초 제품 클립, 반복 배경, 또는 여러 클립을 이어 붙인 멀티씬 시퀀스 등 무엇이든 대화가 작업을 주도합니다.
내부적으로 OpenClaw 에이전트는 사용자의 지침을 구조화된 작업으로 해석하여, '두 번째와 세 번째 클립 사이에 페이드 전환 추가' 또는 '인스타그램용 정사각형 mp4로 내보내기'와 같은 요청을 개별 처리 단계로 분해합니다. 에이전트는 대화 전반에 걸쳐 컨텍스트를 추적하므로, 후속 편집이 매번 새로 시작하는 대신 동일한 프로젝트를 개선합니다.
이 접근 방식은 빠르게 반복 작업하는 제작자(마케터의 광고 컷 테스트, 강사의 강의 클립 조립, 또는 자체 파이프라인을 구축하지 않고 비디오 기능을 프로토타이핑하는 개발자)에게 적합합니다. 스킬이 ClawHub의 공유 인프라를 통해 실행되므로 분당 렌더링 요금이나 포맷 변환 장벽이 없습니다. 입력 및 출력은 mp4, mov, avi, webm, mkv를 지원하여 첫 메시지부터 기존 미디어 라이브러리와 호환됩니다.
환경 변수
| 변수 | 필수 | 기본값 |
|---|---|---|
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. 수신 요청을 올바른 엔드포인트로 라우팅
아래 표를 사용하여 각 유형의 사용자 요청을 처리할 API 엔드포인트를 결정하세요.
| 사용자 말... | 동작 | SSE 건너뛰기 |
|---|---|---|
| "내보내기" / "export" / "다운로드" / "send me the video" | → §3.5 내보내기 | ✅ |
| "크레딧" / "credits" / "잔액" / "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":"..."}}
다른 작업을 진행하기 전에 먼저 세션이 설정되어야 합니다. 이 세션 토큰은 이후 모든 API 상호작용에 필요합니다.
브라우저에서 열기: 세션 생성 후, 사용자에게 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>"}]}}'
모든 대화 메시지는 지속적인 SSE(서버 전송 이벤트) 연결을 통해 백엔드로 전송됩니다.
SSE 처리
| 이벤트 | 동작 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 표시 |
| 도구 호출/결과 | 내부적으로 처리, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 515초, 비디오 생성 100300초, 편집 10~30초.
타임아웃: 10분 동안 하트비트만 수신 → 타임아웃으로 간주. 생성 중에는 절대 재전송 금지 (중복 + 이중 청구).
이전 응답이 정상이었다면 후행 "임시 문제 발생" 메시지는 무시하세요.
무음 응답 대체 (중요)
편집 작업의 약 30%는 응답에 텍스트 내용이 없습니다. 이 경우: (1) 빈 응답을 오류로 처리하지 말고, (2) 작업 상태 엔드포인트를 폴링하여 완료를 확인하고, (3) 출력 자산을 직접 검색하며, (4) 정상 응답을 받은 것처럼 결과를 사용자에게 제시하세요.
2단계 생성: 원시 비디오가 생성된 후, 백엔드가 자동으로 배경 음악과 인트로 제목을 추가하는 두 번째 처리 단계를 트리거합니다. 두 단계 모두 완료 상태에 도달해야 최종 자산이 사용자에게 제공됩니다. 1단계의 원시 비디오를 최종 결과로 전달하지 마세요.
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. 비디오: city timelapse (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) 연결이 끊어지기 전 마지막으로 알려진 작업 ID를 캡처; (2) 서버 과부하를 방지하기 위해 재연결 시도 전 최소 3초 대기; (3) 원래 세션 토큰을 사용하여 SSE 연결 재설정; (4) 캡처된 작업 ID를 사용하여 작업 상태 엔드포인트 폴링 재개하여 현재 진행 상황 확인; (5) 최종 상태가 확인되면 작업을 다시 시작하지 않고 결과를 사용자에게 전달.
4. 백엔드 응답을 사용자 대상 언어로 매핑
백엔드는 그래픽 인터페이스가 있다고 가정하고 설계되었으므로 GUI 특정 지침이나 인터페이스 요소 참조를 사용자에게 그대로 전달해서는 안 됩니다.
| 백엔드가 말함 | 수행할 작업 |
|---|---|
| "click [button]" / "点击" | API를 통해 실행 |
| "open [panel]" / "打开" | §3.4를 통해 상태 표시 |
| "drag/drop" / "拖拽" | SSE를 통해 편집 전송 |
| "timeline에서 미리보기" | 트랙 요약 표시 |
| "Export button" / "导出" | §3.5 실행 |
| "계정/청구 확인" | §3.3 확인 |
내용 설명 유지. GUI 동작 제거.
5. 권장 대화 패턴
• 크레딧 낭비를 방지하기 위해 장기 실행 작업을 시작하기 전에 사용자의 의도와 필요한 입력을 확인하세요. • 생성 중에 점진적인 진행 업데이트를 제공하여 사용자가 요청이 처리 중임을 알 수 있도록 하세요. • 작업이 완료되면 다운로드 링크를 제공하기 전에 생성된 내용을 요약하세요. • 사용자가 전달 직후 변경을 요청하면 새 세션을 열기 전에 이전 세션이 여전히 유효한지 확인하세요. • 기술 상태 코드를 사용자에게 표시하기 전에 항상 평이하고 친근한 언어로 번역하세요.
6. 알려진 제약 사항 및 한계
• 비디오
…
[번역을 위해 잘림]