AI 댄스 생성기

AI 댄스 생성기 API: 프로그래밍으로 댄스 비디오 생성

3월 9, 2026

AI Dance Generator 공개 API를 사용하면 프로그래밍 방식으로 댄스 비디오를 생성할 수 있습니다 — 자체 앱, 자동화 스크립트 또는 워크플로에서 직접 호출하세요. 캐릭터 이미지를 업로드하고 참조 댄스 비디오(또는 TikTok 링크)를 제공하면 AI 댄스 비디오 생성기가 나머지를 처리합니다.

콘텐츠 제작 파이프라인 구축, 제품에 AI 비디오 생성 통합, 소셜 미디어 워크플로 자동화 등 어떤 용도든 Dance Generator REST API가 댄스 비디오 생성 과정을 완벽하게 제어할 수 있게 해줍니다.

이 가이드는 인증, 모든 엔드포인트, 요청/응답 예제, AI 댄스 생성기 API를 프로젝트에 통합하기 위한 모범 사례를 다룹니다.

Dance Generator API 시작하기

1. API Key 생성

Dance Generator 계정에 로그인하고 설정 → API Keys로 이동합니다. 생성을 클릭하여 새 키를 생성합니다.

키는 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 형식입니다. 즉시 복사하세요 — 한 번만 표시됩니다.

2. 인증

모든 API 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다:

Authorization: Bearer sk-your-api-key-here

3. 기본 URL

https://dancegenerator.ai/api/v1

모든 엔드포인트는 /api/v1 접두사를 사용합니다.

AI 댄스 생성기 API 엔드포인트

크레딧 확인

AI 댄스 비디오를 생성하기 전에 현재 크레딧 잔액을 확인합니다.

GET /api/v1/credits

예제:

curl https://dancegenerator.ai/api/v1/credits \
  -H "Authorization: Bearer sk-your-api-key"

응답:

{
  "remaining_credits": 500,
  "cost_reference": {
    "per_second": 7,
    "example_10s_video": 70
  }
}

비용은 비디오_길이(초) × 7 크레딧으로 계산됩니다.

캐릭터 이미지 업로드

댄스 비디오에서 애니메이션될 캐릭터 이미지를 업로드합니다.

POST /api/v1/upload/image
  • 형식: multipart/form-data
  • 허용 유형: JPG, PNG, WebP
  • 최대 크기: 10 MB

예제:

curl https://dancegenerator.ai/api/v1/upload/image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@/path/to/character.jpg"

응답:

{
  "url": "https://file.dancegenerator.ai/abc123.jpg",
  "filename": "character.jpg",
  "size": 1024000
}

url을 저장하세요 — 생성 요청에 필요합니다.

참조 비디오 업로드 (선택사항)

참조로 사용할 로컬 댄스 비디오가 있다면 먼저 업로드합니다.

POST /api/v1/upload/video
  • 형식: multipart/form-data
  • 허용 유형: MP4, MOV
  • 최대 크기: 100 MB

예제:

curl https://dancegenerator.ai/api/v1/upload/video \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@/path/to/dance.mp4"

응답:

{
  "url": "https://file.dancegenerator.ai/videos/def456.mp4",
  "filename": "dance.mp4",
  "size": 5120000
}

AI 댄스 비디오 생성

AI 댄스 생성기 API의 핵심 엔드포인트입니다. 캐릭터 이미지와 참조 댄스 비디오(또는 TikTok URL)를 제출하여 AI로 댄스 비디오를 생성합니다.

POST /api/v1/generate

요청 본문 (JSON):

필드유형필수설명
character_image_urlstring예캐릭터 이미지 URL (업로드 엔드포인트에서 획득)
reference_video_urlstring둘 중 하나참조 댄스 비디오 URL
tiktok_urlstring둘 중 하나댄스 참조로 사용할 TikTok 비디오 링크
promptstring아니오생성용 텍스트 프롬프트 (최대 2500자)
character_orientationstring아니오"image" (기본값, 최대 10초) 또는 "video" (최대 30초)
keep_original_soundboolean아니오참조 비디오의 오디오 유지 (기본값: true)

업로드된 비디오를 사용한 예제:

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "reference_video_url": "https://file.dancegenerator.ai/videos/def456.mp4",
    "prompt": "캐릭터를 에너지 넘치게 춤추게 해주세요",
    "character_orientation": "image"
  }'

TikTok URL을 사용한 예제:

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "tiktok_url": "https://www.tiktok.com/@user/video/1234567890",
    "character_orientation": "image"
  }'

응답 (201):

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "cost_credits": 70,
  "remaining_credits": 430,
  "estimated_duration_seconds": 180,
  "created_at": "2026-03-09T10:00:00.000Z"
}

생성에는 보통 2-3분이 걸립니다. 작업 ID를 사용하여 결과를 폴링하세요.

작업 상태 확인

이 엔드포인트를 폴링하여 비디오가 준비되었는지 확인합니다.

GET /api/v1/tasks/:taskId

예제:

curl https://dancegenerator.ai/api/v1/tasks/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk-your-api-key"

응답 (진행 중):

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "progress": 50,
  "result": null,
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": null,
  "error": null
}

응답 (완료):

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "progress": 100,
  "result": {
    "video_url": "https://..."
  },
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": "2026-03-09T10:03:22.000Z",
  "error": null
}

상태 값:

상태설명
pending처리 대기 중
processing비디오 생성 중
success완료 — result.video_url에 비디오 포함
failed생성 실패 — 크레딧 자동 환불

작업 목록

페이지네이션과 선택적 상태 필터링으로 작업 이력을 조회합니다.

GET /api/v1/tasks

쿼리 파라미터:

파라미터유형기본값설명
statusstring—상태별 필터: pending, processing, success, failed
pagenumber1페이지 번호
limitnumber20페이지당 결과 수 (최대 100)

예제:

curl "https://dancegenerator.ai/api/v1/tasks?status=success&page=1&limit=10" \
  -H "Authorization: Bearer sk-your-api-key"

응답:

{
  "tasks": [
    {
      "task_id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "success",
      "cost_credits": 70,
      "created_at": "2026-03-09T10:00:00.000Z",
      "completed_at": "2026-03-09T10:03:22.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42
  }
}

AI 댄스 비디오 생성 전체 워크플로

API를 통해 댄스 비디오를 생성하는 전체 워크플로입니다. curl 사용:

# 1단계: 캐릭터 이미지 업로드
curl https://dancegenerator.ai/api/v1/upload/image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "[email protected]"
# → 응답에서 "url"을 메모

# 2단계: TikTok 참조를 사용하여 댄스 비디오 생성
curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "YOUR_UPLOADED_IMAGE_URL",
    "tiktok_url": "https://www.tiktok.com/@dancer/video/1234567890"
  }'
# → 응답에서 "task_id"를 메모

# 3단계: 결과 폴링 (status가 "success" 또는 "failed"가 될 때까지 반복)
curl https://dancegenerator.ai/api/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-api-key"
# → status가 "success"이면 result.video_url에서 비디오 다운로드

API 오류 처리

모든 Dance Generator API 오류는 일관된 JSON 형식을 따릅니다:

{
  "error": "error_code",
  "message": "사람이 읽을 수 있는 설명",
  "details": {}
}

일반적인 오류 코드:

HTTP 상태오류 코드설명
401invalid_api_keyAPI Key가 누락, 무효 또는 삭제됨
402insufficient_credits크레딧 부족 — 계정을 충전하세요
404task_not_found작업이 존재하지 않거나 다른 사용자의 것
413file_too_large업로드 파일이 크기 제한 초과
415unsupported_media_type지원되지 않는 파일 형식
422validation_error잘못된 요청 파라미터
500internal_error서버 오류 — 나중에 다시 시도하세요
502provider_errorAI 제공업체 일시적 불가

AI 댄스 생성기 API 활용 팁

  • 폴링 간격: 작업 상태는 5-10초마다 폴링하는 것을 권장합니다. 대부분의 AI 댄스 비디오는 2-3분 내에 완료됩니다.
  • 크레딧 환불: 댄스 비디오 생성 작업이 실패하면 크레딧이 자동으로 환불됩니다.
  • TikTok 통합: TikTok URL을 댄스 참조로 직접 전달할 수 있습니다 — API가 비디오 다운로드와 처리를 자동으로 합니다.
  • 파일 중복 제거: 같은 파일을 두 번 업로드해도 추가 스토리지를 사용하지 않고 같은 URL이 반환됩니다.
  • CORS 지원: 모든 엔드포인트는 크로스 오리진 요청을 지원하므로 웹 앱에서 댄스 생성기 API를 호출할 수 있습니다.

자주 묻는 질문

AI Dance Generator API란 무엇인가요?

AI Dance Generator API는 개발자가 프로그래밍 방식으로 댄스 비디오를 생성할 수 있는 RESTful 공개 API입니다. 캐릭터 이미지와 참조 댄스 비디오를 제공하면 AI가 캐릭터가 댄스 동작을 수행하는 사실적인 애니메이션을 생성합니다.

댄스 생성기 API는 어떤 비디오 형식을 지원하나요?

API는 참조 비디오로 MP4와 MOV 파일을, 캐릭터 이미지로 JPG, PNG, WebP를 지원합니다. 비디오 파일을 업로드하는 대신 TikTok URL을 직접 전달할 수도 있습니다.

API로 댄스 비디오를 생성하는 비용은 얼마인가요?

AI 댄스 생성기는 크레딧 기반 요금제를 사용합니다. 생성되는 비디오 1초당 7크레딧이 소비됩니다. 예를 들어, 10초 댄스 비디오는 70크레딧입니다. 생성이 실패하면 크레딧이 자동으로 환불됩니다.

자체 애플리케이션에서 댄스 생성기 API를 사용할 수 있나요?

네. Dance Generator 공개 API는 통합을 위해 설계되었습니다. 모든 엔드포인트가 CORS를 지원하므로 웹 앱, 모바일 백엔드, 자동화 스크립트 또는 모든 HTTP 클라이언트에서 호출할 수 있습니다.

AI 댄스 생성기 API로 개발을 시작하세요. 설정 → API Keys에서 첫 번째 키를 만드세요.

Thomas

Thomas

AI 댄스 생성기 API: 프로그래밍으로 댄스 비디오 생성 | 블로그