產生Text-to-Video 產生Image-to-Video 故障診斷效能備註相關文件

Luma AI 模型

本節說明 Luma AI 模型的請求參數和回應欄位。使用此資訊透過 StartAsyncInvoke 操作對 Luma AI 模型進行推論呼叫。本節也包含 Python 程式碼範例，示範如何呼叫 Luma AI 模型。若要在推論操作中使用模型，您需要模型的模型 ID。

模型 ID：luma.ray-v2：0
模型名稱：Luma Ray 2
影片模型的文字

Luma AI 模型會使用非同步 APIs 以非同步方式提示處理模型，包括 StartAsyncInvoke、GetAsyncInvoke 和 ListAsyncInvokes。

Luma AI 模型會使用下列步驟處理提示。

使用者使用 StartAsyncInvoke 提示模型。
等待 InvokeJob 完成。您可以使用 GetAsyncInvoke或 ListAsyncInvokes 來檢查任務完成狀態。
模型輸出將放置在指定的輸出 Amazon S3 儲存貯體中

如需搭配 APIs 使用 Luma AI 模型的詳細資訊，請參閱影片產生。

Luma AI 推論呼叫。


POST /async-invoke HTTP/1.1
Content-type: application/json
{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "your input text here",
    "aspect_ratio": "16:9",
    "loop": false,
    "duration": "5s",
    "resolution": "720p"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

欄位

prompt – （字串）輸出影片所需的內容 (1 <= 長度 <= 5000 個字元）。
aspect_ratio – （列舉）輸出影片的長寬比 ("1：1"、"16：9"、"9：16"、"4：3"、"3：4"、"21：9"、"9：21")。
loop – （布林值）是否要循環輸出視訊。
duration – （列舉） - 輸出視訊的持續時間 ("5s"、"9s")。
解析度 – （列舉）輸出視訊的解析度 ("540p"、"720p")。

MP4 檔案將儲存在 Amazon S3 儲存貯體中，如回應中所設定。

產生Text-to-Video

使用 Luma Ray 2 模型從文字提示產生影片。此模型支援各種自訂選項，包括長寬比、持續時間、解析度和迴圈。

基本Text-to-Video請求


{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "an old lady laughing underwater, wearing a scuba diving suit"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

具有選項Text-to-Video


{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "an old lady laughing underwater, wearing a scuba diving suit",
    "aspect_ratio": "16:9",
    "loop": true,
    "duration": "5s",
    "resolution": "720p"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

其他Text-to-Video範例

具有解析度和持續時間參數的範例。


{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "a car",
    "resolution": "720p",
    "duration": "5s"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

產生Image-to-Video

提供關鍵影格，將靜態影像轉換為動態影片。您可以指定開始影格、結束影格或兩者，以控制影片產生程序。

具有開始影格的基本Image-to-Video


{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "A tiger walking in snow",
    "keyframes": {
      "frame0": {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/jpeg",
          "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3"
        }
      }
    }
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

具有開始和結束影格的影像Image-to-Video


{
  "modelId": "luma.ray-v2:0",
  "modelInput": {
    "prompt": "A tiger walking in snow",
    "keyframes": {
      "frame0": {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/jpeg",
          "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3"
        }
      },
      "frame1": {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/jpeg",
          "data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAIAQMAAAD+wSzIAAAABlBMVEX///+/v7+jQ3"
        }
      }
    },
    "loop": false,
    "aspect_ratio": "16:9"
  },
  "outputDataConfig": {
    "s3OutputDataConfig": {
      "s3Uri": "s3://your-bucket-name"
    }
  }
}

Image-to-Video的其他參數

關鍵影格 – （物件）定義開始（影格 0) 和/或結束（影格 1) 關鍵影格
- frame0 – 啟動關鍵影格映像
- frame1 – 結束關鍵影格影像
- 類型 – 必須為「影像」
- 來源 – 映像來源

故障診斷

使用 Luma AI 模型時的常見問題和解決方案：

任務狀態「失敗」 - 檢查您的 S3 儲存貯體是否具有適當的寫入許可，且儲存貯體存在於與 Bedrock 服務相同的區域中。
映像 URL 存取錯誤 - 確保映像 URLs可公開存取並使用 HTTPS。影像必須為支援的格式 (JPEG、PNG)。
無效的參數錯誤 - 驗證長寬比值符合支援的選項 ("1：1"、"16：9"、"9：16"、"4：3"、"3：4"、"21：9"、"9：21")，持續時間為 "5s" 或 "9s"。
逾時問題 - 用來GetAsyncInvoke檢查任務狀態，而不是同步等待。影片產生可能需要幾分鐘的時間。
提示長度錯誤 - 將提示保留在 1-5000 個字元之間。較長的提示將會被拒絕。

效能備註

Luma AI 模型效能和限制的重要考量事項：

處理時間 - 影片產生通常需要 2 到 5 分鐘的 5 秒影片，以及 4 到 8 分鐘的 9 秒影片，具體取決於複雜性。
影像需求 - 輸入影像應具有高品質，解析度下限為 512x512 像素。支援的影像大小上限為 4096x4096 像素。
輸出影片大小 - 產生的影片範圍從 5-50 MB，取決於持續時間、解析度和內容複雜性。
速率限制 - 非同步 API 呼叫受服務配額約束。監控您的用量，並視需要請求增加配額。
S3 儲存 - 確保輸出影片有足夠的 S3 儲存容量，並考慮成本最佳化的生命週期政策。