무료 MiniMax H3 API: 소리가 있는 영상을 무료로
이제 Revana에서 MiniMax H3 무료 등급을 사용할 수 있습니다. 자체 GPU에서 렌더링하므로 클립이 무료입니다. 텍스트나 이미지를 넣으면 소리가 있는 5~15초 영상이 나옵니다. 무엇을 하는지, 대기열이 어떻게 동작하는지, 호출하는 코드를 안내합니다.
MiniMax H3 Free란
minimax-h3-free 은(는) 전체 스케줄 대신 8단계로 렌더링하는 증류 버전인 FastH3 Omni로 실행하는 MiniMax H3입니다. 유료 제공업체가 아니라 저희가 보유한 GPU에서 실행되기 때문에 무료로 제공할 수 있습니다. 모든 클립에는 영상과 함께 생성된 소리(발소리, 음성, 음악, 공간음)가 있습니다.
| 모델 id | minimax-h3-free |
|---|---|
| 기능 | 텍스트 투 비디오, 이미지 투 비디오(시작 이미지), 참조 이미지 |
| 해상도 | 480p, 720p, 768p (768×1344 세로) |
| 화면 비율 | 9:16, 16:9, 1:1 |
| 길이 | 5~15초 |
| 소리 | 항상, 영상과 함께 생성 |
| 이미지 | 총 최대 4장 |
| 가격 | free |
| 동시 실행 | 계정당 작업 10개, 대기 중 또는 실행 중 |
유료 minimax-h3와는 별개의 모델 id입니다. 유료 모델은 전혀 바뀌지 않으며, 요청마다 어느 쪽을 호출할지 선택합니다.
무료 대기열의 동작 방식
GPU 하나는 한 번에 클립 하나를 만들기 때문에 무료 작업은 차례를 지킵니다.
- 작업은 즉시 접수됩니다.
POST /v1/generations가 다른 모델과 마찬가지로 id와 함께202로 응답하며, GPU에 여유가 생길 때까지 작업은queued로 표시됩니다. - 차례는 계정 단위입니다. 많은 사람이 기다릴 때 GPU는 대기 중인 다음 계정에서 다음 작업을 가져가므로, 한 계정이 작업을 몰아서 보내도 다른 사람들이 밀리지 않습니다.
- 계정당 동시에 10개. 대기 중이거나 실행 중인 무료 작업을 최대 10개까지 둘 수 있습니다. 11번째는
429 concurrency_limit로 거부되며, 하나가 끝나면 다시 보내세요. - 최대 3시간까지 기다립니다. 그 이후에도 대기 중인 작업은
model_busy로 실패하며 요금은 없습니다.
작업이 GPU에 도달하면 768p에서 약 12초에 클립 1초당 10초가 더 걸려 렌더링되므로, 5초 클립은 약 1분이 걸립니다. 10초 정도마다 폴링하세요. 작업이 가질 수 있는 모든 상태는 문서에서 다룹니다.
텍스트로 무료 클립 생성하기
요청은 Revana의 모든 모델과 같습니다. 설정할 max_cost_usd도, 미리 구매할 크레딧도 없습니다.
export REVANA_API_KEY="sr_live_..."
# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-free",
"input": {
"prompt": "A street drummer plays on upturned buckets on a busy corner at night, coins in a hat at his feet, passers-by slowing to watch. The drums echo off the buildings.",
"resolution": "768p",
"aspect_ratio": "9:16",
"duration": 8
}
}'
# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
-H "Authorization: Bearer $REVANA_API_KEY"이미지에서 시작하기
시작 이미지를 image_url로 보내면 클립이 그 이미지에서 시작하며 인물, 사물, 배경이 유지됩니다. image_urls로 최대 3장을 더 추가할 수 있고(총 4장), 프롬프트에서 "Picture 1", "Picture 2" 같은 방식으로 지칭하세요. 이미지는 공개 https 링크의 PNG, JPEG, WebP, GIF여야 하며, 파일만 있다면 먼저 POST /v1/uploads로 업로드하세요.
import os
import time
import requests
API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}
resp = requests.post(f"{API}/generations", headers=HEADERS, json={
"model": "minimax-h3-free",
"input": {
"prompt": "<Picture 1> turns to the camera and smiles, then walks out of frame. Soft cafe chatter.",
"image_url": "https://example.com/portrait.jpg",
"duration": 5,
},
})
resp.raise_for_status()
job = resp.json()
# A free job may wait in the GPU queue before it renders, so poll patiently
while job["status"] in ("queued", "running"):
time.sleep(10)
job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
if job["status"] == "succeeded":
print(job["output"]["urls"])
else:
print("Failed:", job["error"])FastH3 Omni가 할 수 없는 것은 422 invalid_input로 즉시 거부됩니다. 1080p 또는 2K 해상도, 21:9 프레임, 5초 미만 또는 15초 초과 클립, audio: false, 영상 입력, 4장을 초과하는 이미지가 해당합니다. 이런 경우에는 유료 minimax-h3를 사용하세요.
무료와 유료 MiniMax H3 중 무엇을?
아이디어를 시도하거나, 스토리보드 초안을 만들거나, 768p로 충분한 소셜 클립을 만들 때는 무료 모델을 쓰세요. 2K, 더 넓은 프레임, 첫 프레임과 마지막 프레임, 더 많은 참조 이미지가 필요하거나 클립이 바로 시작되어야 한다면 유료 모델을 쓰세요.
minimax-h3-free | minimax-h3 | |
|---|---|---|
| 가격 | free | 초당 $0.03부터 |
| 엔진 | FastH3 Omni: 8단계 MiniMax H3, 자체 GPU | 전체 단계의 MiniMax H3, 유료 경로 |
| 해상도 | 최대 768p | 768p, 2K |
| 화면 비율 | 9:16, 16:9, 1:1 | 21:9 포함 더 다양 |
| 첫 프레임과 마지막 프레임 | no | yes |
| 참조 이미지 | 최대 4장 | 최대 9장 |
| 대기 | 무료 대기열에서 다른 모든 사용자와 함께 대기 | 즉시 시작 |
전체 라인업은 Hailuo 및 MiniMax 가이드에 있고, 가장 저렴한 영상 API 가이드에서는 모든 유료 모델의 최저 가격을 다룹니다. 모든 모델은 모델 페이지에, 크레딧 팩은 요금 페이지에 있으며, API 키를 받아 샘플을 실행해 볼 수 있습니다.
자주 묻는 질문
MiniMax H3 무료 API는 정말 무료인가요?
네. minimax-h3-free 작업은 견적, 보류, 청구가 모두 0이므로 크레딧이 없는 계정에서도 사용할 수 있습니다. 실패한 작업도 무료입니다.
minimax-h3-free와 minimax-h3는 어떻게 다른가요?
minimax-h3-free 은(는) 8단계로 증류된 MiniMax H3(FastH3 Omni)를 자체 GPU에서 최대 768p로 렌더링합니다. minimax-h3는 유료 경로의 MiniMax 전체 모델로, 2K, 더 다양한 화면 비율, 첫 프레임과 마지막 프레임을 지원합니다. 둘 다 소리를 생성합니다.
무료 작업을 동시에 몇 개 실행할 수 있나요?
계정당 10개이며, 대기 중이거나 실행 중인 작업을 합산합니다. 11번째는 내 작업 중 하나가 끝날 때까지 429 concurrency_limit로 거부됩니다.
무료 클립은 얼마나 걸리나요?
렌더링이 시작되면 약 12초에 클립 1초당 10초가 더 걸리므로, 5초 클립은 대략 1분이 걸립니다. GPU가 바쁠 때는 작업이 먼저 대기열에서 다른 계정과 번갈아 가며 최대 3시간까지 기다립니다.
내 이미지를 보낼 수 있나요?
네. 시작 이미지 1장은 image_url로, 참조 이미지는 image_urls로 최대 4장(총 4장)까지 https 링크로 보내세요. 프롬프트에서는 "Picture 1", "Picture 2" 같은 방식으로 지칭합니다.