MiniMax-H3 API

한눈에 보기

MiniMax-H3 API는 POST https://api.mage.space/v1/minimax_h3/generate를 통해 Mage에서 MiniMax-H3 Turbo와 다른 1개 모델을 실행합니다. 기본 설정의 요청은 30 Gems(약 $0.03)이며 구독이 필요 없습니다. MiniMax-H3는 저장된 캐릭터, 참조, 오디오 참조를 프롬프트에서 @handle로 불러올 수 있습니다.

• 비디오

  출력

• 2

  변형

• 30

  클립당 Gems(기본)

• $0.03

  약 USD 기준

개요

MiniMax-H3 API로 할 수 있는 일

화면과 스테레오 오디오를 함께 생성하는 빠른 오픈 영상 모델입니다. 시작 및 종료 프레임 또는 최대 8개의 참조를 지원하며(긴 클립일수록 적게 사용 가능), 최대 768p에서 5~15초 길이로 생성합니다.

영상과 스테레오 오디오를 함께 생성하는 빠른 오픈 영상 모델입니다.

입력으로 first_image, last_image, image, additional_images, videos를 받아요.

빠른 시작

MiniMax-H3 API 호출하기

MAGE_API_KEY를 설정하고 /minimax_h3/generate로 요청을 보낸 뒤, 요청이 완료될 때까지 status_url을 폴링하세요.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "5",
  "model_id": "minimax-h3-turbo"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('minimax_h3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'minimax-h3-turbo',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_h3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "minimax-h3-turbo",
})

print(request["result"]["url"])

모델

MiniMax-H3 model_id 값

model_id를 보내 버전을 선택하세요. 지정하지 않으면 기본 모델이 실행됩니다.

옵션

MiniMax-H3 파라미터

모든 버전에서 허용되는 값입니다. 일부 버전은 지원 범위가 더 좁을 수 있습니다. 버전별 옵션은 문서에서 확인하세요.

입력

MiniMax-H3가 지원하는 미디어 입력

각각 https URL, data URL 또는 최대 100 MB 업로드로 보내세요.

규칙

MiniMax-H3 API의 제한 사항

• 첫 프레임과 마지막 프레임은 참조 이미지나 참조 영상과 함께 사용할 수 없어요. 둘 중 한 종류만 보내 주세요.
• 참조 이미지는 최대 9개, 각각 2~15초 길이의 참조 영상은 최대 3개까지 사용할 수 있습니다.
• 참조는 클립과 함께 21초의 한도를 공유합니다. `duration`에 참조 이미지, 언급된 캐릭터, 언급된 참조 하나당 2초, 참조 영상 1초당 1.15초(`duration`까지만 계산)를 더한 값이 21 이하여야 합니다.

더 많은 영상 모델

Mage의 다른 영상 생성 API

FAQ

자주 묻는 질문

Mage로 지금 시작하세요

계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.

관련 항목

• AI 영상 생성 API
• MiniMax-H3 API 레퍼런스
• MiniMax-H3 플레이그라운드
• 모든 API 모델
• Mage MCP 서버