Rivya Public API v1에서 MiniMax H3을 모델 ID minimax-h3, 지원 입력, 파라미터, Files API 규칙, 크레딧, 응답 예시와 함께 사용하세요.

API로 사용 가능텍스트 또는 URL 준비됨; 참조 모드는 Files API 사용비디오

API 모델 ID

minimax-h3

입력

text, file

Files API

참조 모드에 필요

기본 크레딧

크레딧은 입력과 설정에 따라 달라집니다. 생성 전에 예상 비용을 확인하세요. 최종 작업 비용은 정수 크레딧으로 올림 처리됩니다.

기능

비디오

과금

METERED

프롬프트 제한

7000 자

요청 계약

모델 ID는 최상위 수준에 보냅니다. 모델별 제어값은 params에 넣습니다.

Key	유형	필수	기본값	설명
model	string	예	minimax-h3	minimax-h3을 API 모델 ID로 사용합니다.
prompt	string	예	-	이 모델은 최대 7000자까지 사용할 수 있습니다.
params	object	아니요	-	모델별 파라미터 객체입니다. 허용되는 키는 아래 행을 확인하세요.
client_request_id	string	아니요	-	자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다.

모델 파라미터

Key	유형	필수	기본값	범위	옵션	설명
seedance_scene	select	아니요	text	-	text, frames, reference	업로드 전에 MiniMax 입력 방식을 선택하세요. 텍스트, 프레임, 참조에는 서로 다른 요구 사항이 적용됩니다.
resolution	select	아니요	2K	-	768P, 2K	선택한 단계에 따라 출력과 검증된 입력 비디오 시간의 합에 적용할 초당 요율이 정해집니다.
aspect_ratio	select	아니요	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	adaptive는 참조 모드에서 사용할 수 있지만 텍스트 모드에서는 사용할 수 없습니다. 프레임 모드는 이 제어 값을 전송하지 않고 이미지 크기를 사용합니다.
minimax_single_frame_role	select	아니요	first	-	first, last	예. 이미지가 한 장이면 시작 프레임인지 마지막 프레임인지 선택하세요. 두 장이면 시작, 마지막 순서로 배치하세요.
duration	number	아니요	6	min 4 / max 15 / step 1	-	출력 길이를 4초부터 15초까지 정수로 선택하세요.

업로드 정책

참조 파일을 먼저 업로드한 다음 반환된 URL과 durationToken을 params.referenceMediaItems 안에 넣으세요.

참조 규칙

가이드 프레임 또는 멀티모달 참조 자료: 프레임 장면은 파일당 최대 30MB인 JPEG, PNG 또는 WebP 이미지 1장이나 2장을 지원합니다. 참조 장면은 이런 이미지 최대 9장, 파일당 최대 50MB이자 길이 2~15초인 MP4/MOV 비디오 3개, 파일당 최대 15MB이자 길이 2~15초인 MP3/WAV 오디오 파일 3개를 지원합니다. 비디오와 오디오 총길이는 각각 15초이고, 모든 미디어는 총 15개 파일로 제한되며 오디오는 단독으로 사용할 수 없습니다.

최대 파일 수

허용되는 파일 종류

image, video, audio

재생시간 토큰

재생시간 검증이 필요한 경우 비디오 및 오디오 참조는 /api/v1/files의 durationToken을 포함해야 합니다.

kind	최대 크기	MIME 유형
image	30 MB	image/jpeg, image/png, image/webp
video	50 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

최소 요청

{
  "model": "minimax-h3",
  "prompt": "스튜디오 테이블 위에 놓인 제품이 담긴 병 주위를 카메라가 천천히 돈다.",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

참조 파일 요청

{
  "model": "minimax-h3",
  "prompt": "스튜디오 테이블 위에 놓인 제품이 담긴 병 주위를 카메라가 천천히 돈다.",
  "params": {
    "seedance_scene": "reference",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

생성 응답

생성 엔드포인트는 공개 작업 ID를 반환합니다. 작업이 성공하거나 실패할 때까지 상태 엔드포인트를 폴링하세요.

{
  "id": "task_minimax_h3_example",
  "status": "queued",
  "model": "minimax-h3",
  "reserved_credits": 78,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

일부 모드는 Files API 참조 업로드가 필요합니다.

MiniMax H3 API 연동