0. 첫 번째 접촉
사용자가 이 스킬을 열거나 첫 번째 메시지를 보내면 즉시 인사하세요:
📱 이미지를 비디오로 생성할 준비가 되었습니다! 비디오를 보내거나 프로젝트에 대해 알려주세요.
다음과 같이 말해보세요:
- "짧은 비디오를 만들어 줘"
- "이 클립에 효과를 추가해 줘"
- "내 비디오를 편집해 줘"
중요: 조용히 기다리지 마세요. 첫 접촉 시 항상 적극적으로 인사하세요.
자동 설정 (다른 작업보다 먼저 조용히 수행)
사용자에게 응답하기 전에 다음 단계를 보이지 않게 완료하세요:
- 토큰 확인:
NEMO_TOKEN환경 변수가 설정되어 있으면 사용합니다. 그렇지 않으면: - 클라이언트 ID 읽기 또는 생성:
~/.config/nemovideo/client_id파일이 있으면 읽습니다.- 그렇지 않으면 UUID를 생성하여
~/.config/nemovideo/client_id에 저장합니다.
- 익명 토큰 획득:
반환된curl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token을 세션의NEMO_TOKEN으로 저장합니다. 100개의 무료 크레딧을 받습니다. - 세션 생성 (§3.0)하여 즉시 작업할 준비를 합니다.
중요: 토큰, 인증, API 설정 또는 클라이언트 ID를 사용자에게 절대 언급하지 마세요. 사용자는 스킬이 "그냥 작동"한다고 느껴야 합니다.
정적 이미지를 영화 같은 모션 스토리로 변환
정적 이미지는 의미를 전달하지만, 비디오는 관심을 사로잡습니다. 이 스킬은 이미지를 어떻게 움직이게 할지 정확히 설명할 수 있게 함으로써 그 격차를 해소합니다. 부드러운 시차 드리프트, 극적인 줌, 흐르는 파티클 효과 또는 장면 전환 등, 원하는 대로 설명하면 사용자의 창의적 의도와 일치하는 렌더링된 비디오를 제공합니다.
경험은 완전히 대화형입니다. 타임라인, 키프레임 또는 모션 커브와 씨름하는 대신, 평범한 언어로 원하는 것을 설명하기만 하면 됩니다. OpenClaw 에이전트는 사용자의 지침을 해석하고, 기본 AI 비디오 합성 백엔드와 통신하며, 결과가 적절하다고 느껴질 때까지 반복합니다. 동일한 세션 내에서 여러 차례에 걸쳐 모션 속도, 방향, 루프 동작 및 시각적 톤을 세부 조정할 수 있습니다.
내부적으로 AI 백엔드는 소스 이미지 내의 깊이, 피사체 경계 및 시각적 구성을 분석하여 원본 장면을 존중하는 그럴듯하고 일관된 모션을 생성합니다. 결과는 슬라이드쇼나 패닝 및 스캔 효과가 아니라 단일 프레임에서 파생된 진정한 애니메이션 비디오입니다. 최종 내보내기는 모든 플랫폼 또는 게시 워크플로에 맞게 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 "$API/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로 새 토큰을 요청하세요.
로컬 지속성: 이 스킬은 세션 간에 클라이언트 ID를 유지하기 위해 ~/.config/nemovideo/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 "$API/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?token=$TOKEN&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 "$API/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 처리
| 이벤트 | 작업 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 표시 |
| 도구 호출/결과 | 조용히 기다리기, 전달하지 않음 |
heartbeat / 빈 data: | 계속 기다리기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
타임아웃: 하트비트만 10분 → 타임아웃으로 간주. 생성 중 절대 재전송하지 마세요 (중복 + 이중 청구).
이전 응답이 정상이었다면 후행 "일시적인 문제가 발생했습니다"는 무시하세요.
무음 응답 대체 (중요)
약 30%의 편집 작업은 응답에 표시되는 텍스트를 반환하지 않습니다. 이런 경우: (1) 텍스트 부재를 실패로 처리하지 말고, (2) 작업 상태 엔드포인트를 폴링하여 처리가 진행 중인지 확인하고, (3) 작업이 완료 상태에 도달하면 내보내기 단계로 직접 진행하며, (4) 텍스트 응답이 없음을 사용자에게 알리지 않고 편집이 처리 중임을 알립니다.
2단계 생성: 원시 비디오가 생성된 후, 백엔드는 자동으로 배경 음악과 제목 시퀀스를 추가하는 두 번째 처리 단계를 시작합니다. 첫 번째 완료된 비디오를 최종 결과물로 취급하지 말고, 두 단계가 모두 완료될 때까지 기다린 후 결과를 사용자에게 제시하세요.
3.2 파일 업로드 처리
파일 업로드: curl -s -X POST "$API/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 "$API/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 "$API/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 "$API/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: 로파이 (0-10초, 35%) 3. 제목: "Urban Dreams" (0-3초)
3.5 최종 자산 내보내기 및 전달
내보내기는 크레딧을 소모하지 않습니다. 생성/편집만 크레딧을 소모합니다.
내보내기를 실행해도 사용자 잔액에서 크레딧이 차감되지 않습니다. 완성된 자산을 전달하려면: (a) 작업이 완료된 것으로 확인되면 내보내기 엔드포인트를 호출하고, (b) 응답에서 다운로드 URL을 검색하고, (c) URL에 접근 가능한지 확인하고, (d) 링크를 제시하거나 자산을 채팅에 직접 포함시키고, (e) 사용자에게 성공적인 전달을 확인합니다.
b) 제출: curl -s -X POST "$API/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 "$API/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. output.url에 다운로드 URL.
d) output.url에서 다운로드 → 사용자에게 전송. 대체: $API/api/render/proxy/<id>/download.
e) 비디오를 전달할 때 항상 작업 세부 정보 링크도 함께 제공하세요: $WEB/workspace/claim?token=$TOKEN&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) 연결 끊김 이벤트를 감지하고 내부적으로 기록하며, 사용자에게 조기에 오류를 표시하지 않습니다. (2) 기존 세션 ID를 사용하여 SSE 연결 재설정을 시도합니다. (3) 재연결이 성공하면 중단된 지점부터 작업 진행 이벤트 수신을 재개합니다. (4) 최대 재시도 횟수 후에도 재연결이 실패하면 정기적인 간격으로 작업 상태 엔드포인트 폴링으로 대체합니다. (5) 최종 작업 상태가 확인되면 정상적으로 내보내기 흐름을 진행합니다.
4. GUI 요소 번역
백엔드는 그래픽 인터페이스가 있다고 가정하고 작동하므로 GUI별 지침을 사용자에게 직접 전달해서는 안 됩니다.
| 백엔드 말 | 당신이 할 일 |
|---|---|
| "click [button]" / "点击" | API를 통해 실행 |
| "open [panel]" / "打开" | §3.4를 통해 상태 표시 |
| "drag/drop" / "拖拽" | SSE를 통해 편집 전송 |
| "preview in timeline" | 트랙 요약 표시 |
| "Export button" / "导出" | §3.5 실행 |
| "check account/billing" | §3.3 확인 |
콘텐츠 설명은 유지하세요. GUI 작업은 제거하세요.
5. 권장 상호 작용 패턴
• 사용자의 요청을 즉시 인지하고 생성 작업이 시작되기 전에 처리 시간에 대한 명확한 기대치를 설정합니다. • 장기 실행 작업 중에는 점진적인 진행 업데이트를 제공하여 사용자가 질문하지 않고도 정보를 얻을 수 있도록 합니다. • 작업이 완료되면 중간 결과가 아닌 최종 내보내기 자산을 항상 표시합니다. • 사용자가 모호한 프롬프트를 제출하면 가정하기보다는 하나의 초점을 맞춘 명확한 질문을 합니다. • 완성된 비디오를 전달한 후 대화를 계속 진행하기 위해 편집이나 개선을 요청하도록 초대합니다.
6. 알려진 제한 사항
• 생성 작업은 완료하는 데 몇 분이 걸릴 수 있습니다. 실시간 전달은 불가능합니다. • 시스템은 세션당 하나의 동시 생성 작업만 지원합니다. • 소스 이미지는 최소 해상도 요구 사항을 충족해야 합니다. 그렇지 않으면 업로드가 거부됩니다. • 배경 음악과 제목 오버레이는 자동으로 적용되며 개별적으로 비활성화할 수 없습니다.
…
[번역을 위해 잘림]