申請と使用
Luma Videos API を使用するには、まず Luma Videos Generation API ページにアクセスし、「Acquire」ボタンをクリックして、リクエストに必要な認証情報を取得します：
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。
初回申請時には無料のクレジットが付与され、この API を無料で使用できます。
基本使用
生成したいビデオに関して、任意のテキストを入力できます。例えば、宇宙と火山の間を行き来する宇宙飛行士に関するビデオを生成したい場合は、Astronauts shuttle from space to volcano と入力します。以下のようになります：
prompt：生成するビデオのプロンプト。aspect_ratio：ビデオのアスペクト比、デフォルトは 16:9。end_image_url：オプション、指定された尾フレーム。enhancement：オプション、鮮明度向上スイッチ。loop：ループビデオを生成するかどうか、デフォルトは false。timeout：オプション、タイムアウト秒数。callback_url：非同期コールバックアドレス。
- 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をアップロードする必要があります。以下にビデオIDを使用して拡張する方法を示します。次に、キーワードを入力してカスタムビデオを生成する必要があります。以下の内容を指定できます：video_idとvideo_urlは生成後のビデオのIDとビデオリンクです。ビデオの生成方法がわからない場合は、上記の基本的な使用を参照してビデオを生成してください。
- action：この時、ビデオを拡張する行動で、ここでは
extendです。 - prompt：拡張するビデオのキーワード。
- video_url：拡張生成するビデオのリンク。
- video_id：拡張生成するビデオのユニークID。
- end_image_url：拡張生成するビデオに指定する最後のフレームの画像リンク（オプション）。
次に、上記の基礎の上に最後のフレーム画像情報を追加します。具体的には以下の通りです：
非同期コールバック
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 を取得できます。以下のように表示されます：
callback_url を上記の Webhook URL に設定し、prompt を入力します。以下のように表示されます：
内容は以下の通りです：
task_id フィールドがあり、他のフィールドは上記と似ているため、このフィールドを通じてタスクの関連付けが可能です。