Claude Opus 5.5을(를) SeedRouter에서 사용할 수 있습니다

Video

MiniMax H3

View Markdown

MiniMax H3로 768P 또는 2K, 4~15초 길이의 사운드 포함 클립을 생성하세요. 텍스트로 동영상 생성, 첫 프레임과 마지막 프레임, 참조로 동영상 생성을 지원하며 MiniMax 공식 요청 형식으로 작업을 전달합니다.

Standard와 Pro

두 채널 모두 content_filter를 지원합니다. 기본값은 true이며 생성 전에 콘텐츠를 검사합니다. Playground에서는 항상 켜져 있고, API 호출자는 false로 설정할 수 있습니다. 공급업체의 콘텐츠 제한은 여전히 적용될 수 있습니다.

minimax-h3는 Pro이며 기존 요청 형식과 동작을 유지합니다. 아래의 기본 형식 설명은 Pro에 해당합니다. Standard는 minimax-h3-standard를 사용하며 동일한 /v1/videos/generations 엔드포인트에 별도의 평면 JSON 본문을 보냅니다. Max나 Turbo 버전이 아닙니다. 두 옵션 간에 자동 대체는 이루어지지 않습니다.

{
  "model": "minimax-h3-standard",
  "prompt": "A sailboat crosses a quiet bay, with soft wind and waves.",
  "quality": "high",
  "content_filter": true,
  "duration_s": 5,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}

Standard는 아래 필드만 허용합니다. URL은 인증 정보가 없는 공개 HTTP(S) 주소여야 합니다. 파일 직접 업로드와 base64는 허용하지 않습니다.

필드유형필수 / 기본값값
modelstring필수minimax-h3-standard
promptstring필수빈 문자열 불가; 모든 모드에서 필수
qualitystring필수low, high; 동일 요금
duration_snumber55–15, 소수 허용
resolutionstring768p480p, 768p, 1080p, 2k, 4k
aspect_ratiostring16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9
seedinteger무작위0–9223372036854775807
watermarkbooleanfalsetrue / false
enhancebooleantrue프롬프트 재작성; false는 원문 유지
priorityinteger10001000 / 0
content_filterbooleantrue생성 전 SeedRouter 콘텐츠 검사; false는 검사 건너뛰기
first_frame_image_urlstring선택이미지 URL 하나
last_frame_image_urlstring선택첫 프레임 필요
reference_image_urlstring[]선택이미지 URL 1–4개
reference_video_urlstring[]선택동영상 URL 하나

첫 프레임이나 마지막 프레임은 참조 자료와 함께 사용할 수 없습니다. 미디어가 없으면 텍스트로 동영상을 생성합니다. 참조 이미지와 참조 동영상 하나는 함께 사용할 수 있습니다. 독립적인 참조 오디오는 지원하지 않습니다. 모든 출력에는 네이티브 오디오가 포함됩니다. Low는 속도, High는 충실도를 우선하지만 어느 쪽도 Pro와 동일한 화질을 보장하지 않습니다.

이미지: 각 최대 30 MiB이며 JPEG, PNG, WebP, GIF, BMP, TIFF, HEIC, HEIF 또는 AVIF를 지원합니다. 이미지 크기 제한은 없으며 큰 이미지는 생성 전에 축소될 수 있습니다. 동영상: 최대 100 MiB, 0.5–600초이며 읽을 수 있는 영상 스트림(MP4, MOV, WebM 등)이 필요합니다. 너비와 높이는 짝수이고 각각 최소 64픽셀이어야 합니다.

Standard 요금은 ceil(duration_s) × 해당 해상도의 실시간 요율로 계산합니다. 참조 미디어, 오디오, 화질, 프롬프트 재작성에는 추가 요금이 없습니다. 실패한 작업에는 요금이 부과되지 않습니다. 가격은 실시간 요금 섹션에서 가져옵니다.

생성과 폴링은 아래의 공통 비동기 프로토콜을 사용합니다. 성공한 출력에는 video_url, resolution, ratio, duration이 포함되며 duration은 요청한 길이를 나타냅니다. 요금, 공급업체 식별자, 공급업체 URL은 반환하지 않습니다. 제출 결과를 알 수 없으면 자동으로 재시도하지 마세요. 시드가 JavaScript의 안전한 정수 범위를 초과하면 정밀도 손실 없이 직렬화해야 합니다. Number를 거쳐 반올림되지 않도록 하세요.

Pro 참조 문서

MiniMax H3(Hailuo 03)는 MiniMax의 멀티모달 동영상 모델입니다. 요청 한 번으로 화면과 소리를 함께 만듭니다. 결과는 대사, 앰비언스, 효과음이 담긴 768P 또는 2K, 4~15초 클립입니다. 요청 본문은 MiniMax 공식 형식이며 모델 ID는 minimax-h3입니다. 요청을 보내고, 반환된 작업 ID를 보관한 뒤, 완성된 동영상을 작업에서 읽어 오세요. 프레임과 참조는 URL로 전달합니다.

모델 ID

모델 ID입력해상도길이
minimax-h3텍스트, 첫 프레임과 마지막 프레임, 참조 이미지·동영상·오디오768P, 2K4~15초

현재 가격은 모델 페이지에서 확인하세요.

간단한 예제

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "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
헤더값
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

응답은 완성된 동영상이 아니라 작업({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요.

파라미터

필드타입기본값설명
modelstring필수minimax-h3
contentarray필수프롬프트와 미디어를 아래 설명한 항목으로 담습니다. 비어 있지 않은 text 항목이 정확히 하나 있어야 합니다.
resolutionenum필수768P 또는 2K.
durationinteger필수4~15초 사이의 정수.
ratioenum입력에 따라 다름adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. 텍스트만 쓸 때는 필수이며, 이때 adaptive는 받지 않습니다.
content_filterbooleantrueSeedRouter의 콘텐츠 필터(아래 설명). 모델에는 전송되지 않습니다.

스키마는 엄격합니다. 알 수 없는 필드는 무시되지 않고 거부됩니다. callback_url은 사용할 수 없으니 작업을 폴링하세요. extra는 MiniMax-H3-Max용이며 이 모델에서는 받지 않습니다.

Content 항목

type항목role
text{"type": "text", "text": "..."}, 최대 7,000자없음
image_url{"type": "image_url", "image_url": {"url": "https://..."}, "role": "..."}first_frame, last_frame 또는 reference_image
video_url{"type": "video_url", "video_url": {"url": "https://..."}, "role": "reference_video"}reference_video
audio_url{"type": "audio_url", "audio_url": {"url": "https://..."}, "role": "reference_audio"}reference_audio

role 없는 이미지가 하나뿐이면 그 이미지가 첫 프레임입니다. 이미지가 둘 이상이면 모든 이미지에 role이 필요합니다.

모드

모드는 content의 항목으로 정해집니다. 모드 필드는 없습니다.

모드content 내용ratio
텍스트로 동영상 생성text 항목 하나필수, adaptive 불가
이미지로 동영상 생성text와 first_frame 및/또는 last_frame 이미지어떤 값이든 adaptive로 처리되며, 이미지가 화면 형태를 정합니다
참조로 동영상 생성text와 최대 9개의 reference_image, 3개의 reference_video, 3개의 reference_audio 항목의 자유로운 조합선택, 기본값 adaptive

한 요청에서 프레임과 참조를 함께 쓸 수 없습니다.

{
  "model": "minimax-h3",
  "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": "2K",
  "duration": 6
}

미디어 입력

이미지, 동영상, 오디오 항목은 모두 공개 HTTP(S) URL입니다. Base64 data URI와 mm_file:// ID는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요.

입력형식제한
이미지JPG, JPEG, PNG, WebP, HEIC, HEIF30 MB 이하, 각 변 2565760 px, 너비 / 높이 0.42.5
동영상MP4, MOV(H.264 또는 H.265)50 MB 이하, 각 215초, 합계 15초, 각 변 2565760 px, 너비 / 높이 0.42.5, 23.97660 fps
오디오WAV, MP315 MB 이하, 각 2~15초, 합계 15초

참조 동영상은 요청이 접수될 때 길이를 측정합니다. 길이를 읽을 수 없는 동영상은 거부되며 과금되지 않습니다. 그 밖의 제한은 생성 전에 검사하며, 하나라도 어긴 요청은 과금 없이 실패합니다.

콘텐츠 필터

따로 설정하지 않으면 content_filter는 true입니다. 필터가 켜져 있으면 요청(텍스트와 미디어)이 생성 전에 검수됩니다. 표시된 요청은 코드 60001로 실패하며 과금되지 않습니다. 검수를 건너뛰려면 content_filter를 false로 설정하세요. 웹사이트의 Playground에서는 항상 켜져 있습니다.

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. MiniMax H3는 동영상 초 단위로 과금되며, 요율은 출력 해상도로 정해집니다. 여기에 처음 다섯 개를 넘는 입력 이미지가 더해집니다:

billed seconds = duration + ceil(Σ each reference video's seconds)
extra images   = max(0, number of images − 5)
cost = billed seconds × rate per second + extra images × rate per image

첫 프레임, 마지막 프레임, 참조 이미지는 모두 이미지로 셉니다. 참조 오디오는 과금되지 않습니다. 두 수량 모두 요청이 접수될 때 확정되므로, 예약된 금액이 곧 과금되는 금액입니다. 최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 작업은 과금되지 않습니다.

출력 스키마

제출하면 작업이 반환됩니다:

{"id": "task_...", "model": "minimax-h3", "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",
  "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로 선택된 값도 포함합니다. 테스트에서 16:9의 4초 768P 클립은 MP4(H.264), 1344 × 768, 24 fps로 반환되었고, 32 kHz 스테레오 AAC 트랙이 포함되어 있었습니다.

오류

작업이 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 작업은 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.

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

제출 자체가 타임아웃된 경우에는 다시 보내기 전에 작업 목록을 확인하세요. 첫 번째 요청이 이미 접수되었을 수 있습니다.

팁

  • 샷과 그 소리를 함께 설명하세요. 피사체, 장소, 카메라, 빛, 대사, 효과음입니다.
  • 대사는 프롬프트에 쓰고, 목소리가 따라야 한다면 참조 오디오 클립을 첨부하세요.
  • 768P로 초안을 만든 뒤, 같은 요청으로 최종 샷을 2K로 렌더링하세요.
  • 샷의 시작과 끝은 첫 프레임과 마지막 프레임으로, 제품·인물·움직임을 유지하려면 참조로 제어하세요.
  • 지어낸 표시가 들어가지 않도록 no text, no logos를 추가하세요.

관련 자료