Danceo로 AI 댄스 비디오 만들기
사용자가 Danceo의 사용 가능한 참조 템플릿 중 하나의 춤 동작을 사용하여 초상화를 애니메이션화하도록 요청할 때 Danceo를 사용하세요. 이 워크플로우는 렌더링을 생성하고 구성된 API 키에 연결된 계정의 크레딧을 사용합니다.
워크플로우
- 사용자가 공개적으로 접근 가능한 HTTPS 이미지 URL을 제공하지 않은 경우 어떤 초상화 이미지를 사용할지 물어보세요. 이미지와 초상권을 변환할 수 있는 권한이 있는지 확인하세요.
- 렌더링을 시작하기 전에
get_credits를 호출하세요. 반환된 잔액을 보고하세요. 계정에 평가판 크레딧이 있다고 가정하지 마세요. list_dance_templates를 호출하고 요청된 동작과 일치하는 템플릿을 선택하세요. 반환된 그대로id를 사용하세요.- 요청된 출력 시간이 5초에서 30초 사이이고 선택한 참조 시간보다 길지 않은지 확인하세요. 고양이 템플릿의 경우
imageCount가 지정한 수만큼의 초상화를 제공하고, 사람 또는 개 템플릿의 경우 하나의 초상화를 제공하세요. - 현재 API 가격 정책에 따라 출력 초당 80 크레딧으로 렌더링 비용을 추정하세요. 계정 잔액이 이를 충당할 수 있는지 확인한 후, 사용자가 이미 유료 렌더링을 명확히 승인하지 않은 경우 확인을 요청하세요. 확인 후에만
create_dance_video를 호출하세요. - 반환된
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를 사용하세요. - 작업이 보류 중이거나 처리 중인 경우 합리적인 간격으로 계속 폴링하고, 사용자가 요청하지 않는 한 중복 작업을 생성하지 마세요.
링크
- 제품 및 MCP 가이드: https://danceo.ai/mcp
- 가격 정책: https://danceo.ai/pricing