Danceo を使用した AI ダンス動画
ユーザーがポートレートを Danceo の利用可能な参照テンプレートのダンス動作でアニメートしたい場合に Danceo を使用します。このワークフローはレンダリングを作成し、設定された API キーに紐づくアカウントからクレジットを消費します。
ワークフロー
- ユーザーが公開 HTTPS 画像 URL を提供していない場合、使用するポートレート画像を尋ねます。画像と人物の肖像を変換する許可があることを確認します。
- レンダリングを開始する前に
get_creditsを呼び出します。返された残高を報告します。アカウントにトライアルクレジットがあると想定しないでください。 list_dance_templatesを呼び出し、要求された動作に一致するテンプレートを選択します。そのidを返されたまま正確に使用します。- 要求された出力時間が 5 秒から 30 秒の間であり、選択した参照テンプレートの時間を超えないことを確認します。猫テンプレートの場合は、
imageCountで指定された数のポートレートを提供します。人物または犬の場合は、1 つのポートレートを提供します。 - 現在の API 価格に基づき、要求された出力秒あたり 80 クレジットでレンダリングを見積もります。アカウント残高でカバーできることを確認し、ユーザーが有料レンダリングを明確に承認していない限り、確認を求めます。その確認後にのみ
create_dance_videoを呼び出します。 - 返された
job_idを保持します。ステータスがsuccessまたはfailedになるまで、適切な間隔でget_video_statusを呼び出します。成功時は動画 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