Skip to main content
AI の応用が広がるにつれて、さまざまな AI プログラムが徐々に普及しています。AI は人々の仕事や生活のあらゆる面に深く浸透しています。そして、AI が関与する業界もますます増えています。最初のライティングから、医療教育、そして現在のビデオへと至ります。 Luma は専門的で高品質なビデオ生成プラットフォームで、ユーザーは素材をアップロードするだけで、異なるスタイルや効果に基づいて自動的に高品質なビデオを生成できます。この AI ビデオ生成器は、著名なテクノロジー企業のチームメンバーによって開発されており、複雑な編集ツールを必要とせず、誰でも簡単に素晴らしいビデオを制作できることを目指しています。 しかし、Luma 公式は API を提供していません。AceDataCloud は Luma の API を提供し、Suno 公式との接続を模倣して、簡単かつ迅速に希望のビデオを生成できるようにしています。

​
申請と使用

Luma Videos Generation API を使用するには、まず Ace Data Cloud コントロールセンター にアクセスして、API トークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1 つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コントロールセンター で一般残高をチャージできます。
📘 完全なドキュメント：Luma Videos Generation API →

​
基本使用

生成したいビデオに関して、任意のテキストを入力できます。例えば、宇宙と火山の間を移動する宇宙飛行士に関するビデオを生成したい場合は、Astronauts shuttle from space to volcano と入力します。以下のようになります：

生成されたコードは以下の通りです：

主なリクエストパラメータ：
  • prompt：生成するビデオのプロンプト。
  • aspect_ratio：ビデオのアスペクト比、デフォルトは 16:9。
  • end_image_url：オプション、指定された尾フレーム。
  • enhancement：オプション、鮮明度向上スイッチ。
  • loop：ループビデオを生成するかどうか、デフォルトは false。
  • timeout：オプション、タイムアウト秒数。
  • callback_url：非同期コールバックアドレス。
  • async：オプション、true に設定すると、インターフェースはすぐに task_id を返し、callback_url を提供する必要はなく、対応するタスククエリインターフェースを通じて結果をポーリングして取得します。
「Try」ボタンをクリックして API を直接テストし、1-2 分待つと、結果は以下のようになります：
この時点で、ビデオの関連情報が得られました。これにはビデオ ID、ビデオリンク、ビデオサムネイルなどの内容が含まれています。 フィールドの説明は以下の通りです：
  • success：生成が成功したかどうか、成功した場合は true、そうでない場合は false
  • task_id：このビデオ生成タスクのユニーク ID
  • video_id：このビデオ生成タスクから生成されたビデオのユニーク ID
  • prompt：このビデオ生成タスクのキーワード
  • video_url：このビデオ生成タスクの結果ビデオリンク
  • video_height：生成後のビデオサムネイル画像の高さ
  • video_width：生成後のビデオサムネイル画像の幅
  • state：このビデオ生成タスクの状態、タスクが完了している場合は completed。
  • thumbnail_url：生成後のビデオサムネイル画像のリンク
  • thumbnail_width：生成後のビデオサムネイル画像の幅
  • thumbnail_height：生成後のビデオサムネイル画像の高さ

​
カスタムの先頭と尾フレーム生成

カスタムビデオの先頭と尾フレームを使用してビデオを生成したい場合は、先頭と尾フレームの画像リンクを入力できます： この時、ビデオの先頭フレーム start_image_url フィールドには、以下の画像をビデオの先頭フレームとして渡すことができます： 先頭フレーム 次に、先頭と尾フレーム、キーワードに基づいてビデオをカスタマイズして生成するために、以下の内容を指定できます：
  • action：ビデオ生成タスクのアクション、通常は通常生成 generate と拡張生成 extend、デフォルトは generate。
  • start_image_url：生成するビデオの先頭フレームを指定。
  • end_image_url：生成するビデオの尾フレームを指定。
  • prompt：生成するビデオのキーワード内容。
記入例は以下の通りです：

記入が完了すると、自動的に生成されたコードは以下の通りです：

対応するコード：
得られた結果は以下の通りです：
最後に得られた結果は前述のものと似ており、生成されたビデオの先頭フレームには渡した画像が含まれています。もちろん、先頭と尾フレームの画像リンクを同時に渡してビデオを生成することも可能で、上記の内容に尾フレーム画像を追加するだけです。尾フレームの画像情報は以下の通りです： 尾フレーム 記入例は以下の通りです：

最終的結果如下：
結果は上記と似ており、生成された動画には最初のフレームと最後のフレームの画像が含まれており、これによりカスタムの最初と最後のフレームを使用して動画を生成することが完了しました。

​
動画拡張機能

生成された動画をさらに生成したい場合は、パラメータ action を extend に設定し、続けて生成する動画のIDまたは動画リンクを入力します。動画IDと動画リンクの取得は基本的な使用に基づいて行います。以下の図を参照してください：

この時、動画のIDは次のようになります：
注意：ここでの動画の video_id と video_url は生成後の動画のIDと動画リンクです。動画の生成方法がわからない場合は、上記の基本的な使用を参照して動画を生成してください。
動画を続けて生成するには、動画リンクまたは動画のIDをアップロードする必要があります。以下に動画IDを使用して拡張する方法を示します。次に、キーワードを入力してカスタム生成動画を指定する必要があります。以下の内容を指定できます：
  • action：この時、動画を拡張する行動で、ここでは extend です。
  • prompt：拡張する動画のキーワード。
  • video_url：拡張生成する動画のリンク。
  • video_id：拡張生成する動画のユニークID。
  • end_image_url：拡張生成動画に指定する最後のフレームの画像リンク（オプション）。
記入例は以下の通りです：

記入が完了すると、自動的に生成されたコードは以下の通りです：

対応するPythonコード：
実行をクリックすると、次のような結果が得られます：
この動画は、拡張が必要な動画を基に拡張されたことがわかります。結果の内容は上記と一致しており、これにより曲の続きの生成機能が実現されました。 もちろん、動画のリンクを指定して拡張生成することもできます。以下の情報を記入します：

実行後、次のような結果が得られました：
結果から、動画リンクに基づいても動画拡張機能が実現できることがわかります。 最後に、拡張動画の中で指定した最後のフレーム画像を使用して拡張することもできます。以下は最後のフレーム画像の情報です： 最後のフレーム 次に、上記の基礎の上に最後のフレーム画像情報を追加します。具体的には以下の通りです：

実行をクリックすると、次のような情報が得られます：
上記の拡張動画の基礎の上に、最後のフレーム画像を指定して拡張することができることがわかります。

​
非同期コールバック

Lumaが動画を生成するのにかかる時間は比較的長く、約1〜2分かかります。APIが長時間応答しない場合、HTTPリクエストは接続を維持し続け、追加のシステムリソースを消費するため、本APIは非同期コールバックのサポートも提供しています。 全体の流れは次の通りです：クライアントがリクエストを発行する際に、追加で callback_url フィールドを指定します。クライアントが API リクエストを発行した後、API はすぐに結果を返し、現在のタスク ID を示す task_id フィールド情報を含みます。タスクが完了すると、生成された音楽の結果が POST JSON 形式でクライアントが指定した callback_url に送信され、その中にも task_id フィールドが含まれているため、タスクの結果を ID で関連付けることができます。 次に、具体的にどのように操作するかを例を通じて理解しましょう。 まず、Webhook コールバックは HTTP リクエストを受信できるサービスであり、開発者は自分が構築した HTTP サーバーの URL に置き換える必要があります。ここではデモのために、公開の Webhook サンプルサイト https://webhook.site/ を使用します。このサイトを開くと、Webhook URL を取得できます。以下のように示されています：

この URL をコピーすれば、Webhook として使用できます。このサンプルは https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13 です。 次に、フィールド callback_url を上記の Webhook URL に設定し、prompt を入力します。以下のように示されています：

実行ボタンをクリックすると、すぐに結果が得られます。以下のようになります：
少し待つと、https://webhook.site/0c87ca0e-cd74-4577-8d68-f2b80fbf8a13 で生成された曲の結果を観察できます。以下のように示されています： 内容は次の通りです：
結果には task_id フィールドがあり、他のフィールドは上記と似ているため、このフィールドを通じてタスクの関連付けが実現できます。