0. 첫 번째 접촉
사용자가 이 스킬을 열거나 첫 번째 메시지를 보내면 즉시 인사하세요:
⚡ Qwen 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)하여 즉시 작업할 수 있도록 준비합니다.
사용자에게 간략히 알립니다: "설정 중… 준비 완료!" 그런 다음 요청을 진행합니다.
Qwen 인텔리전스 기반 대화형 비디오 제작
qwen-ai-video-generator 스킬은 ClawHub의 OpenClaw 에이전트 프레임워크를 Qwen의 멀티모달 모델에 연결하여 근본적으로 다른 비디오 제작 방식을 가능하게 합니다. 타임라인에서 클립을 드래그하는 대신 장면, 전환, 템포, 내레이션 톤 등 원하는 것을 설명하면 에이전트가 의도를 해석하고 그에 따라 출력을 구성합니다. 이는 편집 소프트웨어와 씨름하는 시간을 줄이고 실제 메시지를 다듬는 데 더 많은 시간을 할애할 수 있음을 의미합니다.
OpenClaw 에이전트는 오케스트레이션 레이어 역할을 하여 대화형 프롬프트를 Qwen이 프레임별로 처리하는 구조화된 생성 작업으로 변환합니다. 제품 둘러보기, 교육용 설명 동영상 또는 짧은 소셜 클립을 제작하든 에이전트는 세션 전반에 걸쳐 컨텍스트를 유지하여 '인트로를 더 짧게' 또는 '10초 지점에 텍스트 오버레이 추가'와 같은 후속 지침을 처음부터 다시 시작하지 않고 처리합니다.
내부적으로 스킬은 인코딩 및 포맷 협상을 자동으로 처리하므로 최종 출력물이 플랫폼에 맞는 컨테이너 포맷, 즉 광범위한 호환성을 위한 mp4, 전문 파이프라인을 위한 mov, 웹 전달을 위한 webm, 보관 및 편집 워크플로우를 위한 avi 및 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로 새 토큰을 요청하세요.
로컬 지속성: 이 스킬은 세션 간에 클라이언트 ID를 유지하기 위해 ~/.config/nemovideo/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 "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>"}]}}'
모든 대화 메시지는 지속적인 서버 전송 이벤트(SSE) 스트림을 통해 백엔드로 전송되고 응답을 수신합니다.
SSE 처리
| 이벤트 | 동작 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 표시 |
| 도구 호출/결과 | 자동 대기, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
시간 초과: 10분 동안 하트비트만 수신되면 시간 초과로 간주합니다. 생성 중에는 절대 재전송하지 마십시오 (중복 요청 + 이중 청구).
이전 응답이 정상이었다면 후행 "일시적인 문제가 발생했습니다" 메시지는 무시하세요.
자동 응답 없음 처리 (중요)
약 30%의 편집 작업이 SSE 스트림에 텍스트 없이 완료된 결과를 반환합니다. 응답에 텍스트 콘텐츠가 감지되지 않으면 이를 오류로 처리하거나 사용자에게 재시도를 요청하지 마십시오. 대신 (1) 작업 상태 엔드포인트를 확인하여 완료를 확인하고, (2) 출력 자산을 직접 검색하고, (3) 완료된 결과를 정상적으로 사용자에게 제시합니다.
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.
API는 사용자가 제공한 미디어 파일을 허용하며, 생성 또는 편집 요청에서 참조되기 전에 지정된 업로드 엔드포인트를 통해 업로드되어야 합니다.
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) 대상 자산 식별자로 내보내기 엔드포인트 호출, (b) 응답에서 내보내기 작업 ID 수신, (c) 작업 상태가 완료에 도달할 때까지 폴링, (d) 완료된 작업 페이로드에서 다운로드 URL 추출, (e) 사용자에게 URL 제시 또는 파일 다운로드.
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) 서버에 부하를 주지 않도록 재연결을 시도하기 전에 최소 2초간 기다립니다. (2) 원래 세션 식별자를 사용하여 SSE 스트림을 다시 엽니다. 새 세션을 생성하지 마십시오. (3) 재연결되면 즉시 작업 상태 엔드포인트를 쿼리하여 중단 중에 처리가 완료되었는지 확인합니다. (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. 권장 상호작용 패턴
• 크레딧을 소모할 생성 요청을 보내기 전에 항상 사용자의 의도를 확인하십시오. • SSE 스트림 이벤트를 수신할 때 점진적인 진행 상황 업데이트를 제공하십시오.