MiniMax H3 Max Turbo

MiniMax H3 Max Turbo는 텍스트나 프레임 이미지로 짧은 동영상을 생성합니다. 모델 ID minimax-h3-max-turbo를 사용하고 반환된 태스크 ID를 보관한 뒤 완성된 동영상을 폴링합니다. 이 페이지는 SeedRouter가 제공하는 네이티브 content 배열 인터페이스를 설명합니다.

모델 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-turbo",
    "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이 없는 단일 이미지는 첫 프레임으로 처리합니다. 첫 프레임과 마지막 프레임을 각각 최대 하나씩 받으며, 마지막 프레임에는 첫 프레임이 필요합니다. 참조 이미지·동영상·오디오는 지원하지 않습니다.

모드

content 항목으로 모드를 결정하며 mode 필드는 전송하지 않습니다.

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

프레임 이미지

인증 정보가 포함되지 않은 공개 HTTP(S) URL을 사용합니다. Base64와 mm_file:// ID는 허용하지 않습니다. JPG, JPEG, PNG, WebP, HEIC, HEIF를 지원하며 각 최대 30 MB, 각 변 2565760픽셀, 가로/세로 0.42.5입니다. 생성 전에 입력을 검사합니다. 두 프레임은 서로 맞는 구도와 화면비를 사용합니다.

콘텐츠 필터

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

과금 항목

모델 가격 섹션에 현재 요율이 표시됩니다. Turbo는 선택한 해상도의 출력 초 수 하나에만 과금합니다. 첫 프레임·마지막 프레임과 프롬프트 확장은 별도 요금이 없습니다.

cost = reported output seconds × output-second rate for the resolution

예상치는 요청한 정수 초를 사용합니다. 최종 과금은 완료된 태스크의 출력 초 사용량과 요청 접수 시 기록한 요율을 사용합니다. 유효한 사용량이 없으면 접수 시 예상치를 사용합니다. 미디어 컨테이너 길이는 과금 초 수와 조금 다를 수 있습니다. 비용은 계정 사용 내역에서 확인하며 공개 태스크 응답에는 요금이 없습니다. 실패한 태스크에는 과금하지 않습니다.

출력 스키마

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

{"id": "task_...", "model": "minimax-h3-max-turbo", "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-turbo",
  "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-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

사용 팁

• 샷 하나마다 피사체, 동작, 카메라 이동, 조명을 하나씩 설명합니다.
• 초안에는 480P, 더 세밀한 출력에는 768P를 사용합니다. 새로 생성할 때마다 별도의 유료 요청입니다.
• 첫 프레임으로 시작 구도를 정하고, 첫 프레임을 제공한 경우에만 마지막 프레임을 추가합니다.
• extra.prompt_expansion_mode로 disabled, balanced, quality를 선택합니다. 생략하면 balanced를 유지합니다.
• 공개 전에 전체 클립과 오디오를 검토합니다. 프롬프트가 제품 형태나 글자의 정확성을 보장하지는 않습니다.

관련 링크

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

계약 범위

이 인터페이스는 MiniMax의 content 배열 요청 형식에 SeedRouter 모델 ID, 비동기 태스크, URL 전용 이미지, 호스팅 결과 전달을 사용합니다. 콜백과 취소는 지원하지 않습니다. content_filter는 MiniMax 파라미터가 아니라 SeedRouter의 입력 검사입니다.

별도의 fal 호스팅 인터페이스는 필드와 제한이 다릅니다. 해당 인터페이스의 1080P, 소수 길이, 지정 오디오, 순서가 있는 참조 제어 항목은 여기에 적용되지 않습니다. 이 인터페이스는 seed와 워터마크 설정을 받지 않습니다. 차이와 출처 링크는 비교 가이드를 참조합니다.