기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Luma AI 모델

이 섹션에서는 Luma AI 모델의 요청 파라미터 및 응답 필드를 설명합니다. 이 정보를 사용하여 StartAsyncInvoke 작업을 통해 Luma AI 모델에 대한 추론 호출을 수행합니다. 이 단원에는 Luma AI 모델을 호출하는 방법을 보여주는 Python 코드 예제도 포함되어 있습니다. 추론 작업에서 모델을 사용하려면 해당 모델의 모델 ID가 필요합니다.

Luma AI 모델은 StartAsyncInvoke, GetAsyncInvoke GetAsyncInvokeListAsyncInvokes APIs를 사용하여 모델 프롬프트를 비동기적으로 처리합니다.

Luma AI 모델은 다음 단계를 사용하여 프롬프트를 처리합니다.

API와 함께 Luma AI 모델을 사용하는 방법에 대한 APIs. https://docs.lumalabs.ai/docs/video-generation

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 버킷에 저장됩니다.

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에 대한 추가 파라미터

문제 해결

Luma AI 모델 작업 시 일반적인 문제 및 해결 방법:

성능 참고 사항

Luma AI 모델 성능 및 제한 사항에 대한 중요한 고려 사항:

관련 설명서

추가 정보 및 관련 서비스: