MiniMax-H3 비디오 생성

APIMaster의 OpenAI 호환 비디오 API로 MiniMax-H3를 사용할 수 있습니다. 생성 작업은 비동기입니다.

Base URL: https://apimaster.ai/v1는 https://apimaster.ai/v1입니다. POST https://apimaster.ai/v1/video/generations로 작업을 생성합니다.

엔드포인트 호환성과 검증

POST https://apimaster.ai/v1/video/generations와 POST https://apimaster.ai/v1/videos/generations를 모두 지원합니다. 같은 모델의 매개변수와 과금 규칙은 동일하며, 생성 응답은 각 경로의 기존 형식을 유지합니다. 기존 클라이언트는 경로를 바꿀 필요가 없습니다.

MiniMax-H3 예제는 단수 경로를 유지하며 size와 resolution, ratio와 aspect_ratio는 별칭입니다. 지원하지 않는 값이나 충돌하는 별칭은 HTTP 400을 반환하고 더 높은 해상도로 자동 변경하지 않습니다. 해상도, 비율, 길이를 명시하세요.

작업 생성

필드	타입	필수	설명
model	string	예	MiniMax-H3
prompt	string	조건부	비디오 설명
duration	integer	아니요	4–15초, 기본값 4
size	string	아니요	768P 또는 2K, 기본값 768P
ratio	string	아니요	화면 비율, 기본값 16:9

curl -s "https://apimaster.ai/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-H3","prompt":"A calm ocean at sunrise, cinematic wide shot","duration":4,"size":"768P","ratio":"16:9"}'

응답은 queued 상태의 id와 task_id를 즉시 반환합니다.

상태 조회

**GET https://apimaster.ai/v1/videos/{task_id}**는 queued, in_progress, completed, failed 상태를 반환합니다.

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"

제출 후 10–20초 기다린 뒤 3–5초 간격으로 조회하세요.

비디오 다운로드

curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o output.mp4

상태가 completed일 때 MP4를 다운로드하세요. duration은 4–15초, size는 768P와 2K를 지원합니다.

참조 이미지 기반 영상 생성(r2v)

위 APIMaster 엔드포인트에 공식 V2 content 배열을 보냅니다. 비어 있지 않은 text 항목이 필요하며, content가 있으면 최상위 prompt는 필요하지 않습니다. reference_image는 대상이나 스타일을 참조하며 첫 프레임을 고정하지 않습니다. 기존 images의 첫 두 이미지는 시작 및 끝 프레임으로 매핑됩니다. 이 역할들을 참조 역할과 혼합하지 마세요.

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
    {"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
  ],
  "resolution": "768P",
  "duration": 4,
  "ratio": "16:9"
}