Luma의 플래그십 Ray 비디오 모델입니다. 텍스트-비디오 및 키프레임(시작/종료 이미지) 생성을 지원하며, 선택적으로 HDR 인코딩 출력과 전문가용 EXR 익스포트를 제공합니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "luma/ray-3.2",
"input": {
"prompt": "A slow aerial pull-back over a misty mountain valley at sunrise, warm golden light breaking through the clouds.",
"resolution": "1080p",
"duration": 5,
"hdr": true,
"exr_export": true
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
prompt | string | Yes | - | 비디오를 설명하는 텍스트 프롬프트입니다. 피사체, 모션, 카메라 움직임, 조명, 페이싱을 구체적으로 작성하세요. |
aspect_ratio | string | No | 16:9 | 생성된 비디오의 화면 비율입니다. start_image 또는 end_image가 설정된 경우 무시되며, 모델이 앵커 프레임에서 비율을 도출합니다. 9:163:41:14:316:921:9 |
resolution | string | No | 720p | 출력 해상도입니다. hdr이 true인 경우 540p는 사용할 수 없습니다. 540p720p1080p |
duration | integer | No | 5 | 비디오 길이(초)입니다. 10초는 hdr, start_image, end_image, loop와 함께 사용할 수 없습니다. 510 |
hdr | boolean | No | false | HDR 인코딩 MP4를 생성합니다. 720p 또는 1080p, 5초 길이, loop 미사용이 필요합니다. |
exr_export | boolean | No | false | 전문가용 컬러 그레이딩 워크플로우를 위해 MP4와 함께 EXR 파일을 익스포트합니다. hdr=true가 필요합니다. |
loop | boolean | No | false | 끊김 없이 반복되는 비디오를 생성합니다. 10초 길이, hdr, end_image와 함께 사용할 수 없습니다. |
start_image | string | No | - | 비디오의 선택적 첫 프레임입니다. 5초 길이에서만 사용할 수 있습니다. |
end_image | string | No | - | 비디오의 선택적 마지막 프레임입니다. 5초 길이에서만 사용할 수 있으며, loop와 함께 사용할 수 없습니다. |
이 모델의 start_imageend_image 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=luma/ray-3.2" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:start_image=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "luma/ray-3.2",
"input": {
"prompt": "your prompt here",
"start_image": "https://example.com/image.jpg"
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
컬러 그레이딩 파이프라인을 위한 5초 HDR 클립을 생성합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "luma/ray-3.2",
"input": {
"prompt": "A slow aerial pull-back over a misty mountain valley at sunrise, warm golden light breaking through the clouds.",
"resolution": "1080p",
"duration": 5,
"hdr": true,
"exr_export": true
}
}'시작 이미지와 종료 이미지로 첫 프레임과 마지막 프레임을 정확히 고정합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "luma/ray-3.2",
"input": {
"prompt": "Smooth camera dolly transitioning from the empty street to the crowded market.",
"start_image": "https://example.com/street-empty.jpg",
"end_image": "https://example.com/street-crowded.jpg",
"duration": 5
}
}'