▥ Seedance 2.5 출시! ›
TEXT TO VIDEO

Text-to-video API

Seedance, Wan, HappyHorse, Grok Imagine, Kling 또는 MiniMax를 사용해 텍스트 프롬프트를 비디오 클립으로 변환하세요. 일부 모델은 생성된 오디오도 지원합니다. 비동기 요청 방식으로 먼저 작업을 받은 다음 비디오를 전달받습니다.

모델

아래의 모든 모델은 POST /v1/videos/generations에서 "text_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

빠른 시작

  1. API 키 생성

    콘솔에서 키를 생성하고 MLMUX_API_KEY 환경 변수로 저장하세요.

    API 키 생성
  2. 요청 전송

    이 예제는 Seedance 2.0 (bytedance/seedance-2.0)을(를) https://api.mlmux.com/v1/videos/generations(으)로 전송합니다. 모델 ID를 위 표에 있는 원하는 모델로 변경하세요.

  3. 결과 확인

    응답은 작업(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": "A red fox walks through fresh snow at sunrise, slow tracking shot, cinematic light",
  "mode": "text_to_video",
  "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"

자주 묻는 질문

Text-to-video에는 어떤 모델을 사용해야 하나요?

Seedance 2.0은(는) 프로덕션 작업의 기본 옵션으로 적합합니다. Seedance 2.5와 Wan 3.0 Prime은 가장 영화 같은 결과물을 제공하고, Kling 4.0은 가장 긴 클립(최대 30초)을 만들며, Grok Imagine Video 1.5 Lite은(는) 초안 작업 및 대량 처리를 위한 최저 비용 옵션입니다.

Text-to-video API 비용은 얼마인가요?

기본 official-cheap 라우트 기준 비디오 1초당 약 $0.027(Grok Imagine Video 1.5 Lite)부터 시작합니다. Seedance는 클립이 사용하는 토큰에 따라 과금되며 다른 모델들은 초당 과금됩니다. 두 방식 모두 해상도와 길이에 따라 달라집니다.

비디오 생성에 시간이 얼마나 걸리나요?

비디오 생성은 비동기로 처리됩니다. 요청 즉시 작업이 반환되며, 몇 초마다 poll_url을 폴링하거나 비디오가 준비되었을 때 웹훅을 수신할 수 있습니다.

실패한 요청에도 요금이 부과되나요? 한도가 있나요?

실패한 요청에는 요금이 청구되지 않으며, 예약된 크레딧은 잔액으로 반환됩니다. 각 계정은 최대 60개의 작업을 동시에 실행할 수 있습니다. 추가 한도가 필요하시면 support@mlmux.com로 문의해 주세요.