Communitygithub.com

AI 댄스 비디오 (Danceo)

사용자가 초상화로 AI 댄스 비디오를 만들거나, 사진에 춤을 넣어 애니메이션화하거나, 댄스 참조 템플릿을 선택하거나, Danceo 렌더링 결과를 확인할 때 사용합니다. Danceo Video MCP 서버와 API 키가 필요합니다.

AI 댄스 비디오 (Danceo)란 무엇인가요?

**AI 댄스 비디오 (Danceo)** 는 사용자가 업로드한 초상화 이미지를 Danceo의 참조 댄스 템플릿 중 하나를 이용해 애니메이션화하는 AI 에이전트 스킬입니다. 이 스킬은 MCP (Model Context Protocol) 서버를 기반으로 작동하며, 사용자가 제공한 HTTPS 이미지 URL과 선택한 댄스 템플릿을 사용하여 렌더링 작업을 생성하고 관리합니다. 주요 기능으로는 계정 크레딧 확인 (`get_credits`), 댄스 템플릿 목록 조회 (`list_dance_templates`), 댄스 비디오 생성 (`create_dance_video`), 작업 상태 폴링 (`get_video_status`) 등이 있습니다. 또한, 출력 시간(5~30초)과 크레딧 비용(초당 80 크레딧)을 확인하고 사용자 승인을 받은 후에만 렌더링을 시작합니다. 이 스킬은 특히 얼굴이 선명하게 보이는 정면 초상화에 적합하며, 개인정보 보호 및 저작권을 준수해야 합니다. 지원 플랫폼은 Danceo MCP 서버를 사용하는 모든 AI 에이전트(예: Claude Code, Cursor 등)입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jasonliu119/danceo-ai-dance-mcp-skills/tree/main/skills/ai-dance-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Danceo로 AI 댄스 비디오 만들기

사용자가 Danceo의 사용 가능한 참조 템플릿 중 하나의 춤 동작을 사용하여 초상화를 애니메이션화하도록 요청할 때 Danceo를 사용하세요. 이 워크플로우는 렌더링을 생성하고 구성된 API 키에 연결된 계정의 크레딧을 사용합니다.

워크플로우

  1. 사용자가 공개적으로 접근 가능한 HTTPS 이미지 URL을 제공하지 않은 경우 어떤 초상화 이미지를 사용할지 물어보세요. 이미지와 초상권을 변환할 수 있는 권한이 있는지 확인하세요.
  2. 렌더링을 시작하기 전에 get_credits를 호출하세요. 반환된 잔액을 보고하세요. 계정에 평가판 크레딧이 있다고 가정하지 마세요.
  3. list_dance_templates를 호출하고 요청된 동작과 일치하는 템플릿을 선택하세요. 반환된 그대로 id를 사용하세요.
  4. 요청된 출력 시간이 5초에서 30초 사이이고 선택한 참조 시간보다 길지 않은지 확인하세요. 고양이 템플릿의 경우 imageCount가 지정한 수만큼의 초상화를 제공하고, 사람 또는 개 템플릿의 경우 하나의 초상화를 제공하세요.
  5. 현재 API 가격 정책에 따라 출력 초당 80 크레딧으로 렌더링 비용을 추정하세요. 계정 잔액이 이를 충당할 수 있는지 확인한 후, 사용자가 이미 유료 렌더링을 명확히 승인하지 않은 경우 확인을 요청하세요. 확인 후에만 create_dance_video를 호출하세요.
  6. 반환된 job_id를 보관하세요. 합리적인 간격으로 get_video_status를 호출하여 상태가 success 또는 failed가 될 때까지 기다리세요. 성공 시 비디오 URL을 반환하고, 실패 시 서비스 오류 및 다음 단계를 반환하세요.

입력 제한

  • 초상화는 HTTPS를 통해 공개적으로 접근 가능해야 합니다.
  • API는 list_dance_templates가 반환한 Danceo 쇼케이스 참조만 허용하며, 임의의 참조 비디오 URL은 허용하지 않습니다.
  • 출력 시간은 5초에서 30초 사이의 정수여야 하며 선택한 참조 시간을 초과할 수 없습니다. 장시간 비디오 처리가 불가능한 동안 서비스는 더 짧은 최대 시간을 적용할 수 있습니다.
  • 현재 API 렌더링 비용은 요청된 출력 초당 80 크레딧입니다. Danceo는 생성 응답에서 최종 비용을 보고하고 API 키 소유자의 잔액에서 청구합니다. 실패한 렌더링은 Danceo의 크레딧 복원 정책을 따릅니다.

올바른 요청

  • 얼굴과 대상이 선명하게 보이는 선명하고 조명이 좋은 초상화를 사용하세요.
  • 초상화에 맞는 프레임과 동작이 있는 참조를 선택하세요.
  • 참조 안무와 호환되는 범위 내에서 사용자가 요청한 신원, 포즈, 시각적 방향을 유지하세요.
  • 허가 없이 사칭을 만들거나 사람의 초상권을 변환하지 마세요. 개인정보 보호, 저작권 및 플랫폼 규칙을 존중하세요.

오류

  • 잘못된 키의 경우 사용자를 Danceo API 키 설정으로 안내하세요.
  • 크레딧이 부족한 경우 get_credits로 잔액을 확인하고 Danceo 가격 정책을 안내하세요.
  • 알 수 없는 템플릿의 경우 list_dance_templates를 다시 호출하고 반환된 ID를 사용하세요.
  • 작업이 보류 중이거나 처리 중인 경우 합리적인 간격으로 계속 폴링하고, 사용자가 요청하지 않는 한 중복 작업을 생성하지 마세요.

링크

관련 스킬