MiniMax-H3 API

정확한 모델 ID MiniMax-H3를 사용하세요. 모델 필드는 이 페이지와 정확히 일치해야 합니다.

샘플 출력MiniMax-H3POST /v1/videos5.2s

매개변수: duration=5resolution=2Kratio=16:9

프롬프트: A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

이 샘플을 생성한 요청

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

인증 및 엔드포인트

https://modelflare.dev/v1과 함께 Modelflare API 키를 사용합니다. 게이트웨이 진입점은 POST /v1/videos입니다.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

작업 생성

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

폴링 및 다운로드

작업 ID를 저장합니다. GET /v1/videos/{task_id}을 폴링하고 GET /v1/videos/{task_id}/content로 다운로드합니다. 결과 URL은 만료될 수 있으므로 즉시 파일을 전송하세요.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

요청 메모

MiniMax-H3은 resolution, duration, ratio 제어 출력과 함께 content[]을 사용합니다.

요청 매개변수

MiniMax-H3은 다중 모드 content[] 배열을 사용합니다. 작업 생성 후 MiniMax 쿼리 경로를 폴링합니다. first_frame / last_frame 및 reference_* 역할은 서로 다른 작업 흐름입니다.

필드	필수	노트
model	예	MiniMax-H3
content[]	예	정확히 하나의 text 항목; first_frame, last_frame, reference_image, reference_video 또는 reference_audio를 포함할 수 있습니다.
resolution	예	768P / 2K
duration	예	4~15초
ratio	조건부	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	조건부	이미지-비디오에는 first_frame / last_frame을 사용하고 참조 작업 흐름에는 reference_*를 사용합니다. 그룹을 섞지 마십시오
content[].url	아니요	공개 HTTP/HTTPS URL이 필요합니다. Base64 미디어는 지원되지 않습니다.
aigc_watermark	아니요	워터마크 추가 여부
callback_url	아니요	작업 상태 콜백 URL

입출력 제한

출력은 4~15초 동안 768P 또는 2K입니다. 텍스트 전용 요청에는 구체적인 ratio이 필요합니다. 이미지-비디오는 첫 번째 프레임 하나와 마지막 프레임 하나를 허용하는 반면, 참조 워크플로에는 하나 이상의 참조 이미지 또는 비디오가 필요하며 오디오만 사용할 수 없습니다. 두 역할 그룹을 혼합하지 마십시오.

문서화된 워크플로우 예시

MiniMax-H3 미디어 URL은 공개적으로 액세스 가능해야 하며 Base64를 사용할 수 없습니다. 첫 번째/끝 프레임과 참조 워크플로를 혼합하면 안 됩니다.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

오류 및 실패한 작업

잘못된 모델 매개변수는 요청 ID와 함께 4xx를 반환합니다. 비동기 작업은 생성이 성공한 후 실패 상태로 들어갈 수도 있습니다. 최종 작업 사유로 폴 응답의 error_code 및 error_message을 사용합니다. 다른 JSON 형태로 동일한 요청을 재시도하지 마세요.

지원 범위

이 페이지에서는 Modelflare 모델 생성 및 편집 호출을 다룹니다. 검색 또는 지도 강화, 음성 관리 및 요소 라이브러리 관리는 이 공개 모델 호출 표면 외부의 리소스 API이며 필수 요청 필드가 아닙니다.

가격 및 청구

이 모델은 초당 비디오 과금을 사용합니다. 현재 고객 가격, 참조 정가 및 전체 사양은 모델 가격 페이지를 참조하세요.

참고

이 페이지는 Modelflare의 공개 인터페이스를 문서화합니다. 여기에 표시된 필드와 한도는 현재 계약입니다.

변형

모델 ID	차이점
MiniMax-H3	이 페이지에 문서화된 모델입니다.