翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Luma AI モデル

このセクションでは、Luma AI モデルのリクエストパラメータとレスポンスフィールドについて説明します。この情報を使用して、StartAsyncInvoke オペレーションで Luma AI モデルの推論呼び出しを実行します。このセクションでは、Luma AI モデルを呼び出す方法を示す Python コード例も示します。推論オペレーションでモデルを使用するには、そのモデルのモデル ID が必要です。

Luma AI モデルは、StartAsyncInvoke、GetAsyncInvoke、ListAsyncInvokes などの非同期 API を使用してモデルプロンプトを非同期的に処理します。

Luma AI モデルは、次のステップを使用してプロンプトを処理します。

API で 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"
    }
  }
}

[フィールド]

MP4 ファイルは、レスポンスの設定に従って Amazon S3 バケットに保存されます。

テキストから動画生成

Luma Ray 2 モデルを使用してテキストプロンプトから動画を生成します。このモデルは、アスペクト比、長さ、解像度、ループなど、さまざまなカスタマイズオプションをサポートしています。

基本的なテキストから動画リクエスト

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

高度なテキストから動画 (オプションを使用)

{
  "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"
    }
  }
}

テキストから動画の追加例

resolution および duration パラメータの例。

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

画像から動画生成

キーフレームを提供することで、静的画像を動的動画に変換します。開始フレーム、終了フレーム、またはその両方を指定して、動画生成プロセスを制御できます。

基本的な画像から動画 (開始フレームを使用)

{
  "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"
    }
  }
}

画像から動画 (開始フレームと終了フレームを使用)

{
  "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"
    }
  }
}

画像から動画の追加パラメータ

トラブルシューティング

Luma AI モデルを使用する際の一般的な問題と解決策:

パフォーマンスについての備考

Luma AI モデルのパフォーマンスと制限に関する重要な考慮事項:

関連するドキュメント

追加情報および関連サービスについては、以下を参照してください。