MiniMax H3 동영상 만들기

POST

videos

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A paper boat glides across a still pond, daylight, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=2544x1456'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "minimax-h3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

텍스트, 참조 미디어 또는 첫 번째와 마지막 프레임으로 MiniMax H3 또는 H3-Max 동영상을 만듭니다. 반환된 id를 저장하여 작업을 폴링하고 완성된 동영상을 다운로드하세요. POST /v1/videos multipart/form-data을 사용합니다. 제어 항목은 양식 필드로 전송하고 각 참조 필드는 미디어 입력마다 한 번씩 반복하세요.

모델 선택

model을 다음 모델 ID 중 하나로 설정하세요. 요청 크기는 해당 모델 표에서 선택하세요: 기간 및 크기 설정.

모델 ID	해상도 등급
`minimax-h3`	`768P`, `2K`
`minimax-h3-max`	`480P`, `768P`

입력 모드 선택

두 모델 모두 아래 필드를 사용합니다. model을 선택한 모델 ID로 설정하세요.

목표	필수 필드	선택 필드
텍스트-동영상 변환	`model`, `prompt`	`seconds`, `size`
참조 이미지	`model`, `prompt`, 하나 이상의 `input_reference` URL 또는 파일	`seconds`, `size`
참조 동영상 URL, 데이터 URI 또는 파일	`model`, `prompt`, 하나 이상의 `reference_videos` 필드	`seconds`, `size`
이미지와 함께 제공하는 참조 오디오	`model`, `prompt`, `input_reference`, 하나 이상의 `reference_audios` 필드	`seconds`, `size`
첫 번째 및 마지막 프레임 URL	`model`, `prompt`, `first_frame`	`last_frame`, `seconds`, `size`
업로드한 첫 번째 및 마지막 프레임	`model`, `prompt`, `first_frame` 파일	`last_frame` 파일, `seconds`, `size`

H3-Max 요청 예제에는 두 해상도 등급의 텍스트-동영상 변환, 참조 이미지, 결합된 이미지/동영상/오디오 참조, 첫 번째 및 마지막 프레임이 포함됩니다.

참조 이미지 사용

공개적으로 액세스 가능한 HTTPS URL 또는 업로드한 파일로 input_reference을 통해 참조 이미지를 전송하세요. 여러 이미지를 전송하려면 이미지 순서대로 필드를 반복하고 필드마다 URL 또는 파일을 하나씩 지정하세요. 이 필드에서는 URL만 모두 사용하거나 파일만 모두 사용하세요. URL을 쉼표로 구분된 값으로 결합하지 말고 각각 별도로 전송하세요. URL 또는 업로드한 파일을 사용하여 PNG 또는 JPEG 참조 이미지를 최대 9개까지 전송할 수 있습니다. 업로드하는 각 이미지는 20MiB 이하로 유지하세요. 프롬프트(Prompt)에서 생성된 동영상이 유지해야 하는 시각적 세부 정보를 설명하세요.

참조 비디오 및 오디오 사용

아래 형식을 사용하여 reference_videos 및 reference_audios을(를) 멀티파트 텍스트 값 또는 업로드된 파일로 전송하세요. 각 입력마다 각 필드를 한 번씩 반복하고, 해당 필드 내에서는 텍스트 값만 또는 파일만 사용하세요. 입력을 쉼표로 구분된 값으로 결합하지 마세요. 이미지 URL과 업로드된 오디오 파일처럼 서로 다른 필드에서 서로 다른 입력 유형을 사용할 수 있습니다. 이미지, 비디오, 오디오 참조를 결합하려면 동일한 요청에서 input_reference, reference_videos, reference_audios을(를) 전송하세요.

필드	입력	형식
`reference_videos`	직접 액세스할 수 있는 공개 HTTPS MP4 URL 또는 업로드된 MP4 파일	H.264 비디오가 포함된 MP4, AAC 오디오 트랙은 선택 사항
`reference_videos`	텍스트 필드의 완전한 Base64 데이터 URI	`data:video/mp4;base64,<BASE64_MP4>`
`reference_audios`	직접 액세스할 수 있는 공개 HTTPS MP3 URL 또는 업로드된 MP3 파일	MP3

비디오는 최대 3개, 오디오 클립은 최대 3개를 포함하여 총 12개 이하의 참조 입력만 전송하세요. 각 비디오 또는 오디오 클립은 2~15초여야 합니다. 비디오 총 길이와 오디오 총 길이는 각각 15초 이하여야 합니다. input_reference을(를) 통해 참조 오디오를 하나 이상의 이미지와 연결하세요. 생성된 비디오가 따라야 하는 동작, 타이밍 또는 사운드를 설명하세요. 업로드하는 각 MP4는 50 MiB 이하로, 각 MP3는 15 MiB 이하로 유지하세요. 1 MiB는 1024 × 1024바이트입니다. 이 페이지 상단의 요청 샘플은 이미지와 연결된 MP4 URL, MP4 데이터 URI 및 MP3 URL을 보여 줍니다.

참조 비디오 업로드

샷 구성과 동작을 안내할 MP4 파일을 업로드하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=Follow the uploaded reference video shot structure and motion. No text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768' \
  --form 'reference_videos=@/path/to/reference.mp4;type=video/mp4'

이미지와 함께 참조 오디오 업로드

참조 이미지 URL을 업로드된 MP3 파일과 연결하세요:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=Animate the reference image and synchronize the motion with the uploaded reference audio. No text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768' \
  --form-string 'input_reference=https://your-image-host/reference.png' \
  --form 'reference_audios=@/path/to/reference.mp3;type=audio/mpeg'

첫 번째 및 마지막 프레임 설정

시작 이미지에는 first_frame을(를) 전송하고, 종료 이미지에는 선택적으로 last_frame 하나를 전송하세요. 각 필드는 직접 액세스할 수 있는 공개 HTTPS PNG URL 하나 또는 업로드된 PNG 파일 하나를 허용합니다. 업로드하는 각 PNG는 20 MiB 이하로 유지하세요(20 × 1024 × 1024바이트). 프레임 필드를 참조 이미지, 비디오 또는 오디오 필드와 결합하지 마세요. 프레임 기반 생성에는 별도의 요청을 사용하세요. 프레임 입력에서는 size이(가) 해상도 등급을 선택합니다. 서비스는 제공된 프레임에 따라 최종 출력 크기를 정규화할 수 있습니다. 계속해서 size을(를) WxH 형식으로 전송하세요.

반환된 id을(를) 저장하세요. status이(가) completed 또는 failed이 될 때까지 작업을 폴링하세요. 작업이 완료되면 비디오 콘텐츠를 다운로드하세요.

기간 및 크기 설정

두 모델 모두에서 seconds 값을 5부터 15까지의 정수로 설정합니다. 기본값은 5초입니다. 모델에 맞는 표에서 해상도와 종횡비를 선택한 다음, 해당 요청 크기 값을 size에서 WxH 형식으로 전송합니다. 텍스트 및 참조 미디어 요청에서 size는 해상도 등급과 프레이밍 종횡비를 선택합니다. 서비스는 요청한 크기와 제공된 참조 미디어를 기반으로 최종 출력 크기를 정규화할 수 있습니다.

`minimax-h3`의 크기

model=minimax-h3에 사용할 요청 크기는 다음과 같습니다:

해상도	종횡비	요청 크기
`768P`	`21:9`	`1536x672`
`768P`	`16:9`	`1344x768`
`768P`	`4:3`	`1024x768`
`768P`	`1:1`	`768x768`
`768P`	`3:4`	`768x1024`
`768P`	`9:16`	`768x1344`
`2K`	`21:9`	`2912x1280`
`2K`	`16:9`	`2544x1456`
`2K`	`4:3`	`1920x1440`
`2K`	`1:1`	`1440x1440`
`2K`	`3:4`	`1440x1920`
`2K`	`9:16`	`1440x2560`

`minimax-h3-max`의 크기

model=minimax-h3-max에 사용할 요청 크기는 다음과 같습니다:

해상도	종횡비	요청 크기
`480P`	`21:9`	`1120x480`
`480P`	`16:9`	`864x480`
`480P`	`4:3`	`640x480`
`480P`	`1:1`	`480x480`
`480P`	`3:4`	`480x640`
`480P`	`9:16`	`480x864`
`768P`	`21:9`	`1792x768`
`768P`	`16:9`	`1360x768`
`768P`	`4:3`	`1024x768`
`768P`	`1:1`	`768x768`
`768P`	`3:4`	`768x1024`
`768P`	`9:16`	`768x1360`

작업 흐름

작업 생성

멀티파트 폼 요청을 전송하고 반환된 id를 저장합니다.

작업 폴링

다음 API를 MiniMax H3 비디오 검색 status가 completed 또는 failed일 때까지 호출합니다.

결과 다운로드

작업이 completed 상태가 되면 다음 API를 MiniMax H3 비디오 콘텐츠 다운로드 호출하여 MP4 파일을 저장합니다.

인증

Authorization

string

header

필수

Bearer authentication. Use your CometAPI API key.

본문

multipart/form-data

model

enum<string>

기본값:minimax-h3

필수

Model ID for the video task. Use minimax-h3 for 768P or 2K, or minimax-h3-max for 480P or 768P. Choose size from the matching model table.

사용 가능한 옵션:

minimax-h3,

minimax-h3-max

prompt

string

기본값:A paper boat glides across a still pond, daylight, locked camera, no text.

필수

Text that describes the scene, motion, camera behavior, and visual details that the video should preserve.

Minimum string length: 1

seconds

integer

기본값:5

Requested clip duration in whole seconds. Use an integer from 5 through 15. The default is 5.

필수 범위: 5 <= x <= 15

size

string

Requested size in WxH form. For text and reference-media requests, size selects the resolution tier and framing aspect ratio. With first or last frames, size selects the resolution tier. Use the matching model table: minimax-h3 uses 768P or 2K; minimax-h3-max uses 480P or 768P. For example, use 1344x768 for H3 at 768P, 864x480 for H3-Max at 480P, or 1360x768 for H3-Max at 768P. The service can normalize the final output dimensions.

Pattern: ^[1-9][0-9]*x[1-9][0-9]*$

예시:

"1536x672"

"1344x768"

"1024x768"

"768x768"

"768x1024"

"768x1344"

"2912x1280"

"2544x1456"

"1920x1440"

"1440x1440"

"1440x1920"

"1440x2560"

"1120x480"

"864x480"

"640x480"

"480x480"

"480x640"

"480x864"

"1792x768"

"1360x768"

"768x1360"

input_reference

PNG or JPEG reference images. Repeat input_reference with one publicly accessible HTTPS image URL or uploaded image file per field. Send up to nine reference images, whether you use URLs or uploaded files. Use all URLs or all files within this field. Do not combine URLs into a comma-separated value. Keep each uploaded image at or below 20 MiB. Do not combine this field with first_frame or last_frame. Across images, videos, and audio, send at most 12 reference inputs. Each reference video or audio clip must be 2–15 seconds; keep the combined video duration and combined audio duration at or below 15 seconds each. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference video inputs. Repeat reference_videos with a direct publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only text values or only files within this field. Each uploaded file can be up to 50 MiB. Send no more than three video inputs. A complete data:video/mp4;base64,... URI is also accepted as a text value. Use MP4 with H.264 video; an AAC audio track is optional. Do not combine this field with first_frame or last_frame. Across images, videos, and audio, send at most 12 reference inputs. Each reference video or audio clip must be 2–15 seconds; keep the combined video duration and combined audio duration at or below 15 seconds each.

Required array length: 1 - 3 elements

Pattern: ^(https://|data:video/mp4;base64,)

예시:

"https://your-media-host/reference.mp4"

reference_audios

(string<uri> | file)[]

Reference audio inputs. Repeat reference_audios with a direct publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only text values or only files within this field. Each uploaded file can be up to 15 MiB. Send no more than three audio inputs. Pair reference audio with at least one reference image. Do not combine this field with first_frame or last_frame. Across images, videos, and audio, send at most 12 reference inputs. Each reference video or audio clip must be 2–15 seconds; keep the combined video duration and combined audio duration at or below 15 seconds each.

Required array length: 1 - 3 elements

Pattern: ^https://

예시:

"https://your-media-host/reference.mp3"

first_frame

Opening frame input as one direct publicly accessible HTTPS PNG URL or one uploaded PNG file at or below 20 MiB (20 x 1024 x 1024 bytes). Do not combine frame fields with reference media fields.

Pattern: ^https://

예시:

"https://your-image-host/first-frame.png"

last_frame

Optional ending frame input, used with first_frame, as one direct publicly accessible HTTPS PNG URL or one uploaded PNG file at or below 20 MiB (20 x 1024 x 1024 bytes). Do not combine frame fields with reference media fields.

Pattern: ^https://

예시:

"https://your-image-host/last-frame.png"

응답

200 - application/json

Task created. Store the returned id and use it in retrieve and content requests.

string

필수

Task ID. Use this value as task_id in retrieve and content requests.

예시:

"<task_id>"

object

string

필수

Object type for the asynchronous video task.

Allowed value: "video"

model

enum<string>

필수

Model ID that the task uses.

사용 가능한 옵션:

minimax-h3,

minimax-h3-max

status

enum<string>

필수

Task lifecycle status. Poll until the value is completed or failed.

사용 가능한 옵션:

queued,

in_progress,

completed,

failed

progress

integer

필수

Task progress as a coarse percentage.

필수 범위: 0 <= x <= 100

created_at

integer<int64>

필수

Task creation time as a Unix timestamp in seconds.

task_id

string

Compatibility alias for id. This field can be omitted from retrieve responses.

예시:

"<task_id>"

completed_at

integer<int64>

Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.

expires_at

integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url

string<uri>

Video delivery URL. This field appears on completed tasks.

예시:

"https://your-media-host/result.mp4"

error

object

Failure details. This field appears when the task fails.

Show child attributes

마지막 수정일 2026년 9월 14일

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3' \
  --form-string 'prompt=A paper boat glides across a still pond, daylight, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=2544x1456'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "minimax-h3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

콘텐츠 검토

API 키

모델 선택

입력 모드 선택

참조 이미지 사용

참조 비디오 및 오디오 사용

참조 비디오 업로드

이미지와 함께 참조 오디오 업로드

첫 번째 및 마지막 프레임 설정

기간 및 크기 설정

`minimax-h3`의 크기

`minimax-h3-max`의 크기

작업 흐름

인증

본문

응답

​모델 선택

​입력 모드 선택

​참조 이미지 사용

​참조 비디오 및 오디오 사용

​참조 비디오 업로드

​이미지와 함께 참조 오디오 업로드

​첫 번째 및 마지막 프레임 설정

​기간 및 크기 설정

​minimax-h3의 크기

​minimax-h3-max의 크기

​작업 흐름

인증

본문

응답

모델 선택

입력 모드 선택

참조 이미지 사용

참조 비디오 및 오디오 사용

참조 비디오 업로드

이미지와 함께 참조 오디오 업로드

첫 번째 및 마지막 프레임 설정

기간 및 크기 설정

`minimax-h3`의 크기

`minimax-h3-max`의 크기

작업 흐름