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が動画のダウンロードと処理を自動で行います。
  • ファイル重複排除： 同じファイルを2回アップロードしても、追加のストレージを消費せずに同じ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をサポートしているため、Webアプリ、モバイルバックエンド、自動化スクリプト、または任意のHTTPクライアントから呼び出すことができます。

AIダンスジェネレーターAPIで開発を始めましょう。設定 → API Keysにアクセスして、最初のキーを作成してください。

Thomas

Thomas

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