Luma 비디오 생성
AceDataCloud의 Luma Dream Machine API를 통해 AI 비디오를 생성합니다.
설정: 인증 토큰 설정은 authentication 문서를 참조하세요.
빠른 시작
curl -X POST https://api.acedata.cloud/luma/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "일출 때 산 위 호수를 비행하는 드론", "action": "generate", "callback_url": "https://api.acedata.cloud/health"}'
비동기: async task polling 문서를 참조하세요.
POST /luma/tasks에{"task_id": "..."}를 전송하여 폴링합니다.
워크플로우
1. 텍스트-비디오
텍스트 설명만으로 비디오를 생성합니다.
POST /luma/videos
{
"prompt": "정원에서 꽃이 피는 타임랩스",
"action": "generate",
"aspect_ratio": "16:9",
"loop": false,
"enhancement": true
}
2. 이미지-비디오
시작 및/또는 종료 참조 이미지를 사용하여 생성을 안내합니다.
POST /luma/videos
{
"prompt": "장면이 부드러운 바람에 살아 움직입니다",
"action": "generate",
"start_image_url": "https://example.com/scene.jpg",
"end_image_url": "https://example.com/scene-end.jpg",
"aspect_ratio": "16:9"
}
3. 비디오 확장
새로운 프롬프트로 기존 비디오를 계속 생성합니다.
POST /luma/videos
{
"action": "extend",
"video_id": "existing-video-id",
"prompt": "카메라가 계속 숲을 통과하여 앞으로 나아갑니다"
}
종횡비
| 비율 | 사용 사례 |
|---|---|
16:9 | 가로 (기본값) — YouTube, TV |
9:16 | 세로 — TikTok, Instagram Stories |
1:1 | 정사각형 — 소셜 미디어 |
4:3 | 클래식 — 프레젠테이션 |
21:9 | 초광각 — 시네마틱 |
파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
prompt | string | — | 비디오에 대한 텍스트 설명 (필수) |
action | string | "generate" | "generate" 또는 "extend" |
aspect_ratio | string | "16:9" | 비디오 종횡비 |
loop | bool | false | 원활한 루프 생성 |
enhancement | bool | true | 더 나은 결과를 위한 프롬프트 향상 |
start_image_url | string | — | 첫 번째 프레임의 참조 이미지 |
end_image_url | string | — | 마지막 프레임의 참조 이미지 |
video_id | string | — | 확장할 비디오의 ID (video_url 대체) |
video_url | string | — | 확장할 비디오의 URL (video_id 대체) |
timeout | number | — | API가 데이터를 반환할 때까지의 제한 시간(초) |
callback_url | string | — | 비동기 알림을 위한 웹훅 URL |
주의사항
enhancement: true(기본값)은 프롬프트 품질을 향상시키지만 의도를 변경할 수 있습니다. 문자 그대로의 프롬프트가 필요하면false로 설정하세요.- 시작/종료 이미지 URL은 공개적으로 접근 가능해야 합니다.
loop: true는 원활한 루핑 비디오를 생성합니다. 배경 및 소셜 미디어에 적합합니다.- 확장하려면 이전에 완료된 생성의
video_id또는video_url이 필요합니다. - 비디오 생성은 복잡성에 따라 1~5분 정도 소요됩니다.
- 시작 및 종료 이미지는 모두 선택 사항입니다. 부분적인 안내를 위해 하나만 사용할 수 있습니다.
MCP:
pip install mcp-luma| 호스팅:https://luma.mcp.acedata.cloud/mcp| 모든 MCP 서버 보기