Skip to main content
POST
모델 선택: MiniMax-H3-Max는 속도를 우선하는 텍스트 기반 영상, 첫·마지막 프레임 제어 및 멀티모달 참조 생성에 적합합니다. 480P, 768P, 1080P를 지원합니다. 2K나 중간 프레임이 필요하면 MiniMax-H3를 사용하세요.

인증

string
필수
모든 엔드포인트에 Bearer Token 인증이 필요합니다. API 키 페이지에서 키를 받으세요.

모델 선택

MiniMax-H3-Max는 2K를 지원하지 않으며 결과를 Regeneration의 원본 작업으로 사용할 수 없습니다.

생성 모드

요청 필드로 모드가 자동 결정됩니다. mode 필드를 보내지 마세요.
첫·마지막 프레임 필드와 참조 자료를 함께 사용할 수 없습니다. 참조 오디오는 참조 이미지나 영상이 하나 이상 필요합니다. 잘못된 조합은 동기적으로 HTTP 400을 반환하며 작업 생성이나 과금은 이루어지지 않습니다.

요청 매개변수

string
필수
고정값: MiniMax-H3-Max. 대소문자를 구분하지 않으며 minimax-h3-max도 허용됩니다.
string
필수
비어 있지 않은 동영상 설명입니다. 모든 모드에서 필수이며 최대 7000자입니다.
integer
기본값:"5"
동영상 길이(초). 5~15의 정수이며 기본값은 5입니다. 4초는 지원하지 않습니다.
string
기본값:"768P"
출력 해상도: 480P, 768P(기본값), 1080P.1080P에서는 watermark와 별칭 aigc_watermark를 모두 생략하세요. 값이 false여도 전달하지 마세요.
2K, 1440P, 2048P는 지원하지 않습니다. 잘못된 값은 HTTP 400을 반환하며 자동으로 낮은 해상도로 변경되지 않습니다.
string
출력 화면비. size와 ratio 별칭도 사용할 수 있습니다.T2V 값: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • T2V에서 생략하거나 adaptive 사용: 16:9로 대체
  • I2V: 입력 이미지로 결정되며 이 필드는 무시
  • 멀티모달 참조: 선택 사항, 기본값은 adaptive, 구체적인 비율도 지정 가능
string
동영상 첫 프레임으로 사용할 공개 이미지 URL.
string
마지막 프레임으로 사용할 공개 이미지 URL. 단독 또는 first_frame_image와 함께 사용할 수 있습니다.
object[]
first_frame_image / last_frame_image / image_urls를 대체할 수 있는 역할 지정 이미지 배열.첫 프레임과 마지막 프레임은 각각 최대 1장. 이 배열과 image_urls의 참조 이미지는 합계 최대 9장. 프레임 역할과 참조 이미지 역할을 함께 사용할 수 없습니다.
string[]
참조 이미지의 공개 URL 배열. image_with_roles의 참조 이미지와 합계 최대 9장. 모두 참조 이미지로 처리하며 첫·마지막 프레임으로 자동 인식하지 않습니다. 첫 프레임 제어에는 first_frame_image 또는 first_frame 역할을 사용하세요.
string[]
참조 영상의 공개 URL 배열. 단일 영상은 video_url(string)로도 전달할 수 있습니다. 최대 3개, 각 2~15초, 참조 영상 총 길이는 15초 이하.제출 시 과금을 위해 참조 영상 길이를 읽습니다. 읽을 수 없으면 동기적으로 HTTP 400을 반환하며 작업 생성이나 과금은 이루어지지 않습니다.
string[]
참조 오디오의 공개 URL 배열. 단일 오디오는 audio_url(string)로도 전달할 수 있습니다. 최대 3개, 각 2~15초, 참조 오디오 총 길이는 15초 이하. 참조 이미지나 영상이 하나 이상 필요하며 오디오만 사용할 수 없습니다.
boolean
기본값:"false"
AIGC 워터마크 추가 여부. 별칭: aigc_watermark.워터마크는 480P / 768P에서만 지원합니다. 1080P에서는 watermark와 별칭 aigc_watermark를 모두 생략하세요. 값이 false여도 전달하지 마세요.
string
작업이 성공 또는 실패 상태로 종료되면 알림을 받습니다.
MiniMax의 callback_url 대신 webhook을 사용하세요. callback_url은 게이트웨이 내부용입니다.

파라미터 제약

다음 잘못된 파라미터나 조합은 작업 생성 및 과금 전에 HTTP 400을 반환합니다. 참조 영상과 오디오는 각각 2~15초여야 합니다. 영상과 오디오 총 길이는 별도로 계산하며 각각 15초 이하여야 합니다. 초과 자료는 유효한 입력이 아니므로 제출 전에 잘라내세요.
1080P에서는 watermark와 별칭 aigc_watermark를 모두 생략하세요. 값이 false여도 전달하지 마세요.
2K, 중간 프레임 또는 4초 영상이 필요하면 MiniMax-H3를 사용하고 파라미터를 조정하세요.

입력 미디어 제한

전체 요청 본문은 64 MB 이하여야 합니다. 이미지·영상·오디오는 공개 URL을 사용하고 Base64는 사용하지 마세요.

이미지

참조 영상

참조 오디오

참조 오디오는 참조 이미지나 영상과 함께 사용해야 합니다. 영상과 오디오 총 길이는 별도로 계산하며 각각 15초 이하여야 합니다. 입력 미디어가 요건을 충족하지 않으면 생성 중 실패할 수 있습니다. 실패한 작업은 자동 환불됩니다.

예시

첫 프레임 이미지→동영상

첫·마지막 프레임 이미지→동영상

1080P 텍스트 기반 영상

1080P에서는 watermark와 별칭 aigc_watermark를 모두 생략하세요. 값이 false여도 전달하지 마세요.

멀티모달 참조 생성

참조 영상과 오디오는 각각 2~15초여야 합니다. 영상과 오디오 총 길이는 별도로 계산하며 각각 15초 이하여야 합니다. 초과 자료는 유효한 입력이 아니므로 제출 전에 잘라내세요.

작업 조회

제출 시 task_id가 반환됩니다. 작업 상태를 5~10초마다 조회하고 클라이언트 제한 시간은 15분으로 설정하세요.
생성된 동영상 URL은 보통 약 24시간 후 만료됩니다. 즉시 다운로드해 보관하세요.

요금

총 비용에는 생성 영상, 초과 입력 이미지 및 참조 영상 요금이 포함됩니다.
첫·마지막 프레임 및 참조 이미지를 합산합니다. 처음 2장은 무료이고 초과 이미지는 장당 과금됩니다. 참조 영상 총 길이는 15초 이하여야 합니다. 모든 단가는 모델 가격 정책을 따릅니다. 참조 이미지 2장과 참조 오디오를 사용하는 1080P 예시에서는 이미지와 오디오가 무료입니다. 제출 시 예상 금액을 선점합니다. 실패한 작업은 전액 자동 환불되며 최종 금액은 작업 응답의 cost를 기준으로 합니다.

오류

생성 중 실패하면 status = failed와 error.message가 반환되고 자동 환불됩니다.

Response

integer
응답 상태 코드, 성공 시 200
array
초기 작업 상태와 작업 ID를 포함한 제출 결과