MiniMax H3 Max

MiniMax H3 Max는 MiniMax H3의 빠른 생성 버전입니다. 요청 한 번으로 화면과 소리를 함께 생성합니다. 대사, 환경음, 효과음이 담긴 480P 또는 768P, 5~15초 클립을 만듭니다. 요청 본문은 MiniMax 공식 형식이며 모델 ID는 minimax-h3-max입니다. 요청을 전송하고 반환된 태스크 ID를 보관한 뒤 완성된 동영상을 태스크에서 읽어 옵니다. 프레임과 참조는 URL로 전달합니다.

모델 ID

현재 가격은 모델 페이지에서 확인합니다.

간단한 예제

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

엔드포인트

POST https://api.seedrouter.ai/v1/videos/generations

응답은 완성된 동영상이 아니라 태스크({"id": "task_...", "status": "processing"})입니다. GET /v1/tasks/{task_id}를 폴링해 결과를 얻습니다. API 키는 서버 측 코드에 보관합니다.

파라미터

스키마는 엄격합니다. 알 수 없는 필드는 무시하지 않고 거부합니다. callback_url은 지원하지 않으므로 태스크를 폴링합니다. extra는 prompt_expansion_mode만 담을 수 있는 선택 사항의 엄격한 객체입니다. 모든 필드는 null을 거부하므로 선택 필드는 대신 생략합니다.

content 항목

role이 없는 단일 이미지는 첫 프레임입니다. 이미지가 여러 개면 각각 role이 필요합니다.

모드

content 항목이 모드를 결정하며 mode 필드는 없습니다.

프레임과 참조는 요청 하나에서 함께 쓸 수 없습니다. 공식 문서는 마지막 프레임만 넣는 입력을 명시하지만, 첫 프레임과 함께 써야 한다는 상충 조건도 있습니다. SeedRouter에서는 이 경우를 검증하지 않았습니다. 종료 이미지가 필요하면 두 프레임을 함께 사용합니다.

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

미디어 입력

모든 이미지·동영상·오디오 항목은 공개 HTTP(S) URL입니다. Base64 data URI와 mm_file:// ID는 허용하지 않습니다. 자신의 스토리지에 파일을 업로드한 뒤 URL을 전달합니다.

참조 동영상은 요청 접수 시 길이를 측정합니다. 길이를 읽을 수 없는 동영상은 거부하며 과금하지 않습니다. 다른 제한은 생성 전에 확인하고, 위반한 요청은 실패하며 비용이 없습니다.

콘텐츠 필터

직접 설정하지 않으면 content_filter는 true입니다. 필터를 켜면 요청의 텍스트와 미디어를 생성 전에 검토합니다. 차단된 요청은 코드 60001로 실패하며 과금하지 않습니다. content_filter를 false로 설정하면 검토를 건너뜁니다. 웹 Playground에서는 항상 켜져 있습니다.

과금 항목

현재 요율은 모델 가격 섹션에서 확인합니다. MiniMax H3 Max는 출력 해상도에 따라 생성 출력 초 수와 참조 동영상 초 수를 따로 과금합니다. 처음 2개 이미지는 무료이며 이후 이미지는 각각 추가 비용이 발생합니다.

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

참조 동영상 길이를 더한 뒤 가장 가까운 정수 초로 반올림해 최종 사용량을 계산합니다. 따라서 2.4초 클립 두 개는 입력 5초로 계산합니다. 참조 오디오에는 입력 요금이 없습니다. 첫 프레임과 마지막 프레임도 이미지로 세므로 두 프레임만 쓰면 이미지 요금이 없습니다.

Playground 예상치는 가능한 최종 비용을 포함하도록 참조 동영상 길이를 올림합니다. 최종 사용량에는 요청 시 기록한 요율을 적용합니다. 전체 사용량 보고가 없으면 접수한 예상치를 사용합니다. 비용은 계정 사용 내역에서 확인하며 공개 태스크 응답에는 요금이 없습니다. 실패한 태스크에는 과금하지 않습니다.

출력 스키마

제출하면 태스크가 반환됩니다.

{"id": "task_...", "model": "minimax-h3-max", "status": "processing", "created_at": 1789689600}

태스크 조회

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status가 completed 또는 failed가 될 때까지 10~20초마다 폴링합니다. 폴링 중 네트워크 시간 초과는 생성 실패를 뜻하지 않습니다. 태스크 ID를 보관하고 조회를 재개합니다. 진행 상황을 확인하려고 다른 태스크를 만들지 않습니다.

완료된 태스크

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio는 클립을 실제로 생성한 화면비이며 adaptive에서 선택된 화면비도 포함합니다. 보고된 경우 태스크에 실제 해상도, 화면비, 길이가 포함됩니다. 위 JSON은 응답 형태의 예시이며 실측 생성 결과가 아닙니다.

오류

태스크 생성 전에 거부된 요청은 error 객체를 포함한 HTTP 오류를 반환하며 과금하지 않습니다. 접수 후 실패한 태스크는 조회 시 HTTP 200을 반환하고 status: "failed" 및 error 객체를 포함합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 목록을 참조합니다.

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

제출 자체가 시간 초과되면 다시 보내기 전에 태스크를 확인합니다. 첫 요청이 이미 접수되었을 수 있습니다.

사용 팁

• 피사체, 장소, 카메라, 조명, 대사, 효과음을 포함해 샷과 소리를 함께 설명합니다.
• 프롬프트에 대사를 작성하고 목소리가 참조를 따르도록 하려면 참조 오디오를 첨부합니다.
• 480P로 초안을 만들고 더 많은 디테일이 필요하면 768P를 선택합니다. 새 생성은 별도의 유료 요청입니다.
• 이미 완성된 프롬프트에는 extra: {"prompt_expansion_mode": "disabled"}를 사용하거나 balanced / quality 확장을 선택합니다.
• 첫 프레임과 마지막 프레임으로 샷의 시작과 끝을 제어하고, 참조 소재로 제품·인물·동작의 특성을 유지하도록 유도합니다.
• no text, no logos를 추가해 가상의 글자나 로고가 생기지 않도록 합니다.

관련 링크

• MiniMax H3 Max Playground와 가격
• OpenAPI 다운로드
• 복사 가능한 Markdown

계약 출처

파라미터는 MiniMax 동영상 생성 문서를 따릅니다. SeedRouter는 자체 모델 ID와 비동기 태스크 인터페이스, URL 전용 미디어, 호스팅 결과 전달을 사용합니다. 콜백과 취소는 지원하지 않습니다. content_filter는 SeedRouter 확장입니다.