소개
MiniMax H3 HighSpeed의 텍스트에서 영상 생성은 프롬프트 하나를 768p 4~15초 MP4로 바꾸며, 소리도 같은 과정에서 만들어집니다. 해상도를 고를 필요가 없으므로 클립마다 정할 것은 아이디어, 프레임 모양, 길이뿐입니다.
시작 자료에 따라 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 아이디어만 있음 | MiniMax H3 HighSpeed 텍스트에서 영상 |
| 움직일 프레임(선택적으로 마지막 프레임) | MiniMax H3 HighSpeed 이미지에서 영상 |
| 인물, 의상, 장소, 움직임 클립 또는 목소리 | MiniMax H3 HighSpeed 참조에서 영상 |
핵심 기능 및 하이라이트
한 번의 생성으로 소리와 대사
모든 클립에는 소리가 포함되어 돌아옵니다. 큰따옴표 안의 말은 지정한 인물이 말하고, 분위기 소리나 음악은 적은 내용을 따르므로 짧은 장면에는 나중에 소리를 입히는 작업이 필요 없습니다.
가로세로 비율 6종
요청마다 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 중에서 고를 수 있습니다. 요금은 같으므로 같은 프롬프트로 피드용 가로 버전과 릴스·쇼츠용 세로 버전을 만들 수 있습니다.
요금은 하나뿐
초당 $0.072이므로 6초 클립은 $0.432, 10초는 $0.72입니다. 해상도가 하나라서 하루치 대기열의 비용을 시작하기 전에 계산할 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수입니다. 1~7,000자를 받으며 그보다 길면 거부됩니다. 1자 이상 · 7000자 이하 |
aspect_ratio | 아니요 | 프레임 모양입니다. 기본값은 16:9이며 9:16, 1:1, 4:3, 3:4, 21:9도 고를 수 있습니다. |
resolution | 아니요 |
|
duration_seconds | 아니요 | 4~15의 정수(기본값 5)이며 1초마다 768p 요금이 적용됩니다. 4초 요청은 3.75초 클립으로 돌아왔습니다. |
요금
요금은 완성된 클립의 1초마다 768p 단가로 발생합니다. 실시간 단가는 모델 페이지에서 확인하십시오.
| 사양 | 요금 |
|---|---|
| $0.072 / 초 |
활용 사례
매일 올리는 소셜 게시물
5~8초 길이의 9:16 클립에 짧은 대사와 분위기 소리를 넣으면 그대로 게시물에 쓸 수 있습니다. 배경은 날마다 고정하고 동작과 대사만 바꾸십시오.
제품·광고 변형 버전
같은 제품 장면을 프롬프트마다 카메라 움직임, 분위기, 대사를 바꿔 쓰고 가장 잘 전달되는 테이크를 공개하십시오. 모두 완성된 768p 파일입니다.
클라이언트 요청에 빠르게 대응
클라이언트나 유행이 기다려 주지 않을 때, 약 22~35초(저희 테스트의 4초 클립 기준)면 도착하므로 한 번 앉은 자리에서 여러 번 확인하고 조정할 수 있습니다.
프롬프트 가이드 및 실전 팁
장면을 순서대로 쓰기
누가 있고, 먼저와 그다음에 무엇을 하며, 카메라가 어디에 있는지 쓰고, 소리는 Audio: 줄로 지정하십시오. 형용사를 나열하는 것보다 분명한 순서가 움직임을 더 좋게 만듭니다. 골든아워나 네온처럼 빛을 지정하면 분위기가 빠르게 잡힙니다.
대사는 짧게
5~8초 클립에는 따옴표로 묶은 대사 한두 줄이 들어갑니다. 대사마다 말하는 사람을 밝히고, 긴 이야기는 억지로 욱여넣지 말고 여러 클립으로 나누십시오.
동작에 맞춰 길이 정하기
동작 하나는 4~6초면 충분히 전달됩니다. 더 길게 만들 때는 두 번째 전개를 더해 장면이 멈추지 않게 하십시오. 저희 테스트에서 4초 요청은 3.75초로 돌아왔습니다.
요금은 완성된 클립의 1초마다 768p 단가로 발생합니다. 실시간 단가는 모델 페이지에서 확인하십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-highspeed/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
