AIダンスジェネレーターAPI：プログラムでダンス動画を生成

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

https://dancegenerator.ai/api/v1

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
  }
}

POST /api/v1/upload/presign

# ファイルの MD5 ハッシュを計算
MD5=$(md5sum character.jpg | cut -d' ' -f1)

# プリサインアップロード URL をリクエスト
curl https://dancegenerator.ai/api/v1/upload/presign \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d "{\"md5\": \"$MD5\", \"content_type\": \"image/jpeg\"}"

{
  "presigned_url": "https://storage.example.com/...?X-Amz-Signature=...",
  "public_url": "https://file.dancegenerator.ai/uploads/abc123.jpg",
  "deduplicated": false
}

curl -X PUT "<ステップ1で取得した presigned_url>" \
  -H "Content-Type: image/jpeg" \
  --data-binary @character.jpg

POST /api/v1/generate

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"
  }'

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"
  }'

{
  "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"
}

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
}

GET /api/v1/tasks

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
  }
}

# ステップ1：キャラクター画像のプリサイン URL を取得
MD5=$(md5sum character.jpg | cut -d' ' -f1)
curl https://dancegenerator.ai/api/v1/upload/presign \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d "{\"md5\": \"$MD5\", \"content_type\": \"image/jpeg\"}"
# → レスポンスの "presigned_url" と "public_url" を記録

# ステップ2：ファイルを直接アップロード（deduplicated=true の場合はスキップ）
curl -X PUT "<PRESIGNED_URL>" \
  -H "Content-Type: image/jpeg" \
  --data-binary @character.jpg

# ステップ3：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_PUBLIC_URL",
    "tiktok_url": "https://www.tiktok.com/@dancer/video/1234567890"
  }'
# → レスポンスの "task_id" を記録

# ステップ4：結果をポーリング（ステータスが "success" または "failed" になるまで繰り返す）
curl https://dancegenerator.ai/api/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-api-key"
# → ステータスが "success" の場合、result.video_url から動画をダウンロード

{
  "error": "error_code",
  "message": "人間が読めるエラー説明",
  "details": {}
}