공지

무료 MiniMax H3 API: 소리가 있는 영상을 무료로

이제 Revana에서 MiniMax H3 무료 등급을 사용할 수 있습니다. 자체 GPU에서 렌더링하므로 클립이 무료입니다. 텍스트나 이미지를 넣으면 소리가 있는 5~15초 영상이 나옵니다. 무엇을 하는지, 대기열이 어떻게 동작하는지, 호출하는 코드를 안내합니다.

MiniMax H3 Free란

minimax-h3-free 은(는) 전체 스케줄 대신 8단계로 렌더링하는 증류 버전인 FastH3 Omni로 실행하는 MiniMax H3입니다. 유료 제공업체가 아니라 저희가 보유한 GPU에서 실행되기 때문에 무료로 제공할 수 있습니다. 모든 클립에는 영상과 함께 생성된 소리(발소리, 음성, 음악, 공간음)가 있습니다.

MiniMax H3 Free 한눈에 보기
모델 idminimax-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도, 미리 구매할 크레딧도 없습니다.

cURL
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로 업로드하세요.

Python
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 비교
minimax-h3-freeminimax-h3
가격free초당 $0.03부터
엔진FastH3 Omni: 8단계 MiniMax H3, 자체 GPU전체 단계의 MiniMax H3, 유료 경로
해상도최대 768p768p, 2K
화면 비율9:16, 16:9, 1:121:9 포함 더 다양
첫 프레임과 마지막 프레임noyes
참조 이미지최대 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" 같은 방식으로 지칭합니다.

무료 MiniMax H3 클립 만들기

가입하고, API 키를 만들고, 첫 minimax-h3-free 요청을 보내세요. 크레딧은 필요 없으며, 더 필요할 때는 같은 키로 모든 유료 모델을 실행할 수 있습니다.