MiniMax동영상

MiniMax H3 Max 텍스트 → 동영상 API

Name: MiniMax H3 Max API
Brand: MiniMax
SKU: minimax/h3-max
Availability: InStock

MiniMax에서 MiniMax H3 Max 방식으로 제공하는 텍스트 → 동영상 API입니다. 더 선명한 디테일과 뛰어난 프롬프트 반영력을 갖춘 H3.

minimax/h3-max/text-to-video

부터최대 −25%

$0.04/s$0.05

동영상 초당 · 480P

정상 운영100% 가동률 (30일)중앙값 20s

MiniMax H3 Max 사용해 만들기 API 키 발급

API 문서 →모델 비교 →

MiniMax H3 Max 텍스트 → 동영상 사용해 보기

프롬프트*

0/5000

화면 비율

출력 프레임 비율입니다.

해상도

출력 해상도입니다. 해상도가 높을수록 초당 요금이 비쌉니다.

길이

생성할 클립 길이(초) (5–15초). 초당 요금이 부과됩니다.

안전 검사 사용

이 화면에서는 항상 켜져 있습니다. API에서 끄려면 enable_safety_checker를 false로 설정하세요.

true로 설정하면 안전 검사가 켜집니다. 허용 사용 정책에서 금지한 콘텐츠는 설정과 관계없이 차단됩니다.

예상 비용…

Google 또는 이메일로 무료 계정을 만들고 생성한 만큼만 결제하세요.

여기에 동영상 생성 결과가 표시됩니다.

프롬프트를 작성하고 설정을 선택한 뒤 실행하세요. 성공한 생성에만 결제합니다.

다음도 이용 가능: MiniMax H3 Max 이미지 → 동영상

MiniMax H3 Max의 예시 및 프롬프트 보기

MiniMax H3 Max 텍스트 → 동영상 API

POST/api/v1/run/minimax/h3-max/text-to-video

비동기 작업을 제출하고 생성 ID가 포함된 HTTP 202 응답을 반환합니다. GET /api/v1/generations/{id}의 상태를 조회하거나 webhook_url를 전달하세요. 자세한 내용은 작업 수명 주기 문서를 참조하세요.

입력 매개변수

이름	유형	설명	가격에 영향
`prompt`필수	string	피사체, 동작, 카메라 움직임, 조명, 스타일을 설명하세요.	없음
`aspect_ratio`	string (enum)	출력 프레임 비율입니다. 허용값: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 기본값: 16:9	예
`resolution`	string (enum)	출력 해상도입니다. 해상도가 높을수록 초당 요금이 비쌉니다. 허용값: 480P · 768P 기본값: 768P	예
`duration`	integer	생성할 클립 길이(초) (5–15초). 초당 요금이 부과됩니다. 범위: 5–15s 기본값: 6	예
`seed`	integer	같은 시드와 설정을 사용하면 결과를 재현할 수 있습니다. 비워 두면 무작위로 설정됩니다.	없음
`enable_safety_checker`	boolean	true로 설정하면 안전 검사가 켜집니다. 허용 사용 정책에서 금지한 콘텐츠는 설정과 관계없이 차단됩니다. 기본값: true	없음
`webhook_url`	문자열(URL)	선택 사항. 완료된 생성을 웹훅 비밀키로 서명해 이곳으로 POST합니다. 웹훅	없음

요청

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-max/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "빨간 꽃 위에 날개를 멈춘 채 떠 있는 벌새, 빛이 가늘게 비치는 순간을 포착한 자연 다큐멘터리",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/minimax/h3-max/text-to-video", headers=headers, json={
    "prompt": "빨간 꽃 위에 날개를 멈춘 채 떠 있는 벌새, 빛이 가늘게 비치는 순간을 포착한 자연 다큐멘터리",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/minimax/h3-max/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "빨간 꽃 위에 날개를 멈춘 채 떠 있는 벌새, 빛이 가늘게 비치는 순간을 포착한 자연 다큐멘터리",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

응답

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-max",
  "endpoint": "minimax/h3-max/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "빨간 꽃 위에 날개를 멈춘 채 떠 있는 벌새, 빛이 가늘게 비치는 순간을 포착한 자연 다큐멘터리",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-max",
  "endpoint": "minimax/h3-max/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "빨간 꽃 위에 날개를 멈춘 채 떠 있는 벌새, 빛이 가늘게 비치는 순간을 포착한 자연 다큐멘터리",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}