Image-to-video API
이미지에서 시작해 움직임을 설명하면 모델이 이를 애니메이션 비디오 클립으로 변환합니다. 다수의 모델이 시작 프레임과 종료 프레임 지정 또는 여러 참조 이미지를 통한 클립 가이드 기능도 지원합니다.
모델
아래의 모든 모델은 POST /v1/videos/generations에서 image_url과 함께 "image_to_video" 모드를 지원합니다. 요금은 기본 라우트의 표시된 해상도 기준 비디오 1초당 가격이며, Seedance 요금은 토큰 과금 기준의 예상치입니다.
| 모델 및 API 모델 ID | 옵션 | official-cheap 요금 (기본) |
|---|---|---|
Seedance 2.5bytedance/seedance-2.5 | 크기: 480p, 720p, 1080p4~30초 클립 | 720p 초당 $0.213official: $0.231 |
Seedance 2.0bytedance/seedance-2.0 | 크기: 480p, 720p, 1080p, 4K4~15초 클립 | 720p 초당 $0.139official: $0.151 |
Seedance 2.0 Fastbytedance/seedance-2.0-fast | 크기: 480p, 720p4~15초 클립 | 720p 초당 $0.111official: $0.121 |
Seedance 2.0 Minibytedance/seedance-2.0-mini | 크기: 480p, 720p4~15초 클립 | 720p 초당 $0.07official: $0.076 |
Wan 3.0alibaba/wan-3.0 | 크기: 480p, 720p, 1080p2~15초 클립 | 720p 초당 $0.083official: $0.092 |
Wan 3.0 Primealibaba/wan-3.0-prime | 크기: 480p, 720p, 1080p2~15초 클립 | 720p 초당 $0.125official: $0.138 |
HappyHorse 1.1alibaba/happyhorse-1.1 | 크기: 480p, 720p, 1080p3~15초 클립 | 720p 초당 $0.125official: $0.138 |
HappyHorse 1.0alibaba/happyhorse-1.0 | 크기: 720p, 1080p3~15초 클립 | 720p 초당 $0.125official: $0.138 |
Grok Imagine Video 1.5xai/grok-imagine-video-1.5 | 크기: 480p, 720p, 1080p1~15초 클립 | 720p 초당 $0.126official: $0.14 |
Grok Imagine Video 1.5 Litexai/grok-imagine-video-1.5-lite | 크기: 480p, 720p, 1080p1~15초 클립 | 720p 초당 $0.027official: $0.03 |
Kling 4.0kwaivgi/kling-4.0 | 크기: 720p, 1080p3~30초 클립 | 720p 초당 $0.138official: $0.154 |
MiniMax H3minimax/h3 | 크기: 480p, 768p, 2K5~15초 클립 | 768p 초당 $0.072official: $0.08 |
MiniMax H3 Maxminimax/h3-max | 크기: 480p, 768p5~15초 클립 | 768p 초당 $0.072official: $0.08 |
MiniMax H3 Max Turbominimax/h3-max-turbo | 크기: 480p, 768p5~15초 클립 | 768p 초당 $0.036official: $0.04 |
빠른 시작
- API 키 생성
콘솔에서 키를 생성하고 MLMUX_API_KEY 환경 변수로 저장하세요.
API 키 생성 - 요청 전송
이 예제는 Seedance 2.0 (bytedance/seedance-2.0)을(를) https://api.mlmux.com/v1/videos/generations(으)로 전송합니다. 모델 ID를 위 표에 있는 원하는 모델로 변경하세요.
- 결과 확인
응답은 작업(task) 형태로 반환됩니다. status가 succeeded가 될 때까지 몇 초마다 poll_url을 폴링하여 비디오를 다운로드하거나, 알림을 받도록 webhook을 설정하세요.
비디오 API 레퍼런스
curl https://api.mlmux.com/v1/videos/generations \
-H "Authorization: Bearer $MLMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2.0",
"route_mode": "official-cheap",
"prompt": "The camera slowly pushes in while steam rises from the cup",
"mode": "image_to_video",
"image_url": "https://your-cdn.example/start-frame.jpg",
"ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}'
# The response is a task. Poll it until "status" is "succeeded", then read "video".
curl https://api.mlmux.com/v1/videos/generations/TASK_ID \
-H "Authorization: Bearer $MLMUX_API_KEY"자주 묻는 질문
Image-to-video에는 어떤 모델을 사용해야 하나요?
Seedance 2.0은(는) 기본 옵션으로 적합합니다. Seedance 2.5와 Wan 3.0 Prime은 가장 역동적인 움직임을 선사하고, Kling 4.0은 최대 30초 길이의 클립을 생성하며, Grok Imagine Video 1.5 Lite은(는) 가장 비용 효율적인 선택지입니다.
Image-to-video API 비용은 얼마인가요?
기본 라우트 기준 비디오 1초당 약 $0.027(Grok Imagine Video 1.5 Lite)부터 시작합니다. Seedance는 시작 이미지를 참조 비디오가 아닌 참조 이미지로 계산하여 더 낮은 요율을 적용하며, 다른 모델들은 시작 이미지 유무에 상관없이 동일한 초당 요금을 부과합니다.
시작 이미지는 어떻게 전송하나요?
image_url에 공개 URL을 전달하거나 POST /v1/uploads로 파일을 업로드한 후 반환된 URL을 사용하세요. 요청 시 작업이 반환되며, 이를 폴링하거나 비디오가 준비되었을 때 webhook을 수신할 수 있습니다.
실패한 요청에도 요금이 부과되나요? 한도가 있나요?
실패한 요청에는 요금이 청구되지 않으며, 예약된 크레딧은 잔액으로 반환됩니다. 각 계정은 최대 60개의 작업을 동시에 실행할 수 있습니다. 추가 한도가 필요하시면 support@mlmux.com로 문의해 주세요.