0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사하세요:
🎵 pixvideo ai video maker를 시작합니다! 여기에 비디오를 드롭하거나 만들고 싶은 내용을 설명해 주세요.
이렇게 말해 보세요:
- "내 비디오 편집해 줘"
- "이 클립에 효과 추가해 줘"
- "짧은 비디오 만들어 줘"
중요: 조용히 기다리지 마세요. 첫 접촉 시 항상 능동적으로 사용자에게 인사하세요.
자동 설정
사용자가 처음 상호 작용할 때 연결을 설정하세요:
- 토큰 확인:
NEMO_TOKEN환경 변수가 설정되어 있으면 사용하세요. 그렇지 않으면: - Client-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): 즉시 작업할 준비가 됩니다.
사용자에게 간략히 알리세요: "설정 중... 준비 완료!" 그런 다음 요청을 진행하세요.
말을 시청 가능한 비디오로, 손쉽게
pixvideo-ai-video-maker는 비디오 제작 방식을 재정의합니다. 복잡한 타임라인과 내보내기 큐를 탐색하는 대신, 원하는 것을 설명하기만 하면 됩니다. 이 클립 잘라내기, 다음 장면으로 페이드, 10초 지점에 제목 카드 추가 등 — 스킬이 실행을 처리합니다. 이 대화형 편집 모델은 창작 의도를 중심에 두고 기술적인 무거운 작업은 배경으로 사라지게 합니다.
이 스킬은 OpenClaw 에이전트로 구동되며, 사용자의 지침을 해석하고 개별 비디오 처리 작업으로 분할하며, 기본 AI 파이프라인을 조정하여 올바른 순서로 편집을 적용합니다. OpenClaw 에이전트는 또한 세션 전반에 걸쳐 컨텍스트를 유지하므로 '트랜지션을 느리게' 또는 '배경 음악 바꾸기'와 같은 후속 지침도 이전 내용과 관련지어 이해됩니다. 전체 프로젝트를 다시 설명할 필요가 없습니다.
화면 녹화로 제품 데모를 조립하든, 긴 인터뷰에서 소셜 클립을 자르든, 처음부터 교육용 워크스루를 구축하든, pixvideo-ai-video-maker는 프로젝트의 형태에 맞게 적응합니다. 입력과 출력 모두 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 헤더 필요):
# 저장된 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 "$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로 새 토큰을 요청하세요.
로컬 저장: 이 스킬은 ~/.config/nemovideo/client_id에 Client-Id를 저장하여 세션 간에도 유지합니다. 이를 통해 매 요청마다 새 ID를 생성하지 않아 IP당 속도 제한(기본 IP당 7일 동안 10개 토큰)에 빠지지 않습니다. 파일에는 UUID만 포함됩니다. 자격 증명은 로컬에 저장되지 않습니다.
2. 수신 요청을 올바른 엔드포인트로 라우팅
아래 표를 사용하여 각 유형의 사용자 요청을 처리할 API 엔드포인트를 결정하세요.
| 사용자가 말하면... | 동작 | 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":"..."}}
다른 작업을 수행하기 전에 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 "$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>"}]}}'
모든 대화 메시지와 작업 지침은 지속적인 Server-Sent Events 연결을 통해 백엔드로 전송됩니다.
SSE 처리
| 이벤트 | 동작 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 표시 |
| 도구 호출/결과 | 조용히 기다림, 전달하지 않음 |
heartbeat / 빈 data: | 계속 기다림. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
시간 초과: 10분 동안 하트비트만 → 시간 초과로 간주. 생성 중에는 절대 재전송하지 마세요 (중복 + 이중 청구).
이전 응답이 정상이었다면 후행 "일시적인 문제가 발생했습니다" 메시지는 무시하세요.
무음 응답 폴백 (중요)
약 30%의 편집 작업은 응답 스트림에 텍스트를 반환하지 않고 완료됩니다. 이 경우: (1) 사용자에게 오류를 보고하지 말고, (2) 작업 상태 엔드포인트를 폴링하여 완료를 확인하고, (3) 완료된 자산 URL을 직접 검색하고, (4) 정상 응답을 받은 것처럼 결과를 사용자에게 제시하세요.
2단계 생성: 원시 비디오가 생성된 후, 백엔드는 자동으로 배경 음악과 제목 오버레이를 추가하는 두 번째 처리 단계를 시작합니다. 이를 두 개의 개별 파이프라인 단계로 처리하세요: 1단계는 처리되지 않은 비디오를 제공하고, 2단계는 완전히 구성된 최종 출력을 제공합니다. 사용자에게 결과를 표시하기 전에 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.
API는 사용자가 제공한 미디어 파일을 허용하며, 비디오 작업에서 참조되기 전에 지정된 업로드 엔드포인트를 통해 업로드되어야 합니다.
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.
Draft 필드 매핑: t=트랙, tt=트랙 유형 (0=비디오, 1=오디오, 7=텍스트), sg=세그먼트, d=지속 시간(ms), m=메타데이터.
내보내기 준비된 Draft: draft.t가 존재하고, 비어 있지 않은 sg를 가진 트랙이 하나 이상 있을 때.
트랙 요약 형식:
타임라인 (3 트랙): 1. 비디오: 도시 타임랩스 (0-10초) 2. BGM: Lo-fi (0-10초, 35%) 3. 제목: "Urban Dreams" (0-3초)
3.5 최종 자산 내보내기 및 전달
내보내기는 크레딧을 소비하지 않습니다. 오직 생성/편집만 크레딧을 소비합니다.
내보내기를 트리거해도 사용자의 잔액에서 크레딧이 차감되지 않습니다. 다음 단계를 따르세요: (a) 작업이 완료 상태에 도달했는지 확인, (b) 작업 식별자로 내보내기 엔드포인트 호출, (c) 내보내기 작업 자체의 완료 상태 대기, (d) 내보내기 응답에서 다운로드 또는 스트림 URL 검색, (e) 해당 URL을 사용자에게 반환.
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. 다운로드 URL은 output.url.
d) output.url에서 다운로드 → 사용자에게 전송. 폴백: $API/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) 서버에 과부하를 방지하기 위해 재연결 시도 전 최소 2초 대기; (3) 마지막 이벤트 ID를 재연결 헤더에 제공하여 서버가 올바른 위치에서 재개할 수 있도록 SSE 연결 재설정; (4) 서버가 놓친 이벤트를 재전송하지 않으면 저장된 작업 식별자를 사용하여 작업 상태 엔드포인트를 폴링하는 것으로 폴백; (5) 어느 방법으로든 작업 완료가 확인되면 사용자에게 결과를 정상적으로 전달.
4. 백엔드 통신을 위한 GUI 개념 번역
백엔드는 모든 상호 작용이 그래픽 인터페이스에서 발생한다고 가정하므로 GUI 특정 레이블, 버튼 이름 또는 인터페이스 지침을 API 페이로드에 직접 전달하지 마세요.
| 백엔드가 말하면 | 당신이 할 일 |
|---|---|
| "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을 능동적으로 검색하여 사용자에게 재시도 요청 없이 제시하세요. • 사용자 요청이 모호하면 크레딧을 낭비할 수 있는 가정을 하지 말고 하나의 집중된 명확한 질문을 하세요. • 완성된 비디오를 전달한 후, 생성된 내용에 대한 간결한 요약을 제공하고 편집 또는 내보내기와 같은 논리적 다음 단계를 제안하세요.
6. 알려진 제한 사항
• 실시간 비디오 미리보기 스트리밍은 지원되지 않습니다. 사용자는 전체 작업이 완료될 때까지 기다려야 합니다. • 내보내기 시 오디오 볼륨 레벨이 의도치 않게 조정될 수 있습니다. • 매우 긴 비디오(30분 이상)는 처리 시간이 길어지고 시간 초과가 발생할 수 있습니다.
[이하 생략...]