MiniMax H3 HighSpeed API

MiniMax H3 HighSpeed의 참조에서 영상 생성은 제공한 파일을 중심으로 소리가 포함된 4~15초 768p 클립을 구성합니다. 인물과 장소는 이미지, 움직임은 영상, 목소리는 오디오로 지정합니다. 참조 중심 작업은 일상 콘텐츠를 겨냥한 등급에 잘 맞으므로, 얼굴, 의상, 장소를 게시물마다 일관되게 유지해야 할 때 가장 먼저 시도해 보십시오.

시작 자료에 따라 모드 고르기

참조는 최대 15개

요청 한 번에 이미지 9장, 영상 3개, 오디오 3개를 보낼 수 있습니다. 파일마다 인물, 의상, 방, 움직임, 목소리처럼 서로 다른 역할을 맡길 수 있습니다.

프롬프트에서 이름 붙이기

프롬프트에서는 각 파일을 Image 1, Video 1, Audio 1처럼 부릅니다. 예를 들어 ‘Image 1의 여자가 Video 1의 움직임을 한다’고 씁니다. 번호는 보낸 목록의 순서와 같습니다.

입력에 따라 따르는 요금

참조 영상의 초는 출력과 같은 단가로 계산되고, 여섯 번째부터의 이미지에는 소액이 추가되며, 오디오는 무료입니다. 그 밖에는 평소의 초당 요금입니다.

여러 파일로 조립하는 장면

인물 사진, 의상 사진, 방 사진을 이미지 세 장으로 보내고, 인물이 말한다면 목소리 클립을 Audio 1로 더하십시오. 결과에는 그 인물이 그 옷을 입고 그 장소에 있는 장면이 담깁니다.

여러 클립에 걸친 같은 캐릭터

모든 요청에서 같은 인물 사진을 Image 1로 쓰면 장면이 바뀌어도 얼굴과 의상이 게시물 사이에서 이어집니다. 이렇게 하면 반복 등장하는 캐릭터나 가상 진행자가 알아볼 수 있는 모습을 유지합니다.

움직임 따라 하기

짧은 클립을 Video 1로 제공하고 Image 1의 인물로 그 움직임을 재현해 달라고 요청하면 춤, 제스처, 카메라 움직임을 빌려 올 수 있습니다. 그 초가 과금되므로 클립은 짧고 깔끔하게 준비하십시오.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3-highspeed/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "768p",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ]
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.