申請和使用
要使用 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 會立馬返回一個結果，包含一個 task_id 的欄位資訊，代表當前的任務 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 欄位，其他的欄位都和上文類似，通過該欄位即可實現任務的關聯。