MiniMax H3 Spicy API

MiniMax H3 Spicy 영상 연장은 이미 가지고 있는 클립의 뒷이야기를 만듭니다. 클립을 video_url로 보내며, 다음에 일어날 일을 프롬프트로 적을지는 선택입니다. 클립의 마지막 프레임이 3~15초짜리 새 MiniMax H3 Spicy 이미지→영상 샷의 시작 프레임이 되고, 둘은 MP4 하나로 합쳐집니다. 원본이 먼저, 이어진 부분이 그다음이며, 이음매에서 겹치는 프레임은 제거됩니다. 새 구간은 단독 파일로도 돌아오므로 계속 연장하거나 부분별로 따로 편집할 수 있습니다.

연속성은 마지막 프레임에서 나옵니다. 새 구간이 말 그대로 마지막 프레임에서 시작하기 때문에 의상, 배경, 빛, 인물의 위치가 그대로 이어집니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델이 보는 것은 클립 전체가 아니라 정지 이미지 한 장이므로, 속도와 방향이 그대로 유지될 것이라고 가정하지 말고 이어 가려는 움직임을 적으십시오.

파일 하나와 새 부분 단독 파일이 함께 돌아옵니다. 원본의 소리는 그대로 남고, 새 구간의 소리가 그 뒤에 이어집니다. 출력의 첫 번째 에셋은 합쳐진 클립(역할 video)이고, 두 번째는 새 구간만 담긴 파일(역할 segment)이어서 다음 연장이나 편집에 바로 쓸 수 있습니다. 이어 붙인 MP4는 원본 클립의 프레임 레이트와 화면 구성을 유지하며 검은 띠는 생기지 않습니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다.

나머지는 모두 MiniMax H3 Spicy 이미지→영상와 같습니다. 새 구간은 이미지→영상 엔드포인트와 같은 경로, 같은 콘텐츠 허용 범위, 같은 초당 요금으로 생성되며, 생성에 실패했을 때의 환불도 같습니다. 생성은 성공했지만 이어 붙이기만 만들지 못한 경우에도 작업은 실패로 처리되고 요금은 환불됩니다.

결말도 정할 수 있습니다. 목표 마지막 프레임으로 last_image_url을 추가하면 새 구간이 그 이미지에서 끝납니다. 고정되는 것은 결말이며, 중간의 움직임은 고정되지 않습니다.

너무 일찍 끝난 샷을 늘릴 수 있습니다. 라벨이 카메라를 향하기 전에 멈춘 제품 턴테이블이나, 인물이 문에 닿기 전에 끊긴 걸음 장면이 그 예입니다. 몇 초만 연장하고 남은 움직임만 적으십시오.

더 긴 시퀀스를 한 단계씩 쌓을 수 있습니다. 첫 샷을 만들어 연장하고, 합쳐진 결과를 다시 연장하십시오. 각 단계는 더해진 초만 과금합니다. 단계마다 프레임 한 장에서 시작하므로, 다음 단계를 쌓기 전에 이음매를 확인하십시오.

# 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-spicy/video-extend",
  "input": {
    "duration_seconds": 5,
    "resolution": "480p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# 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 레퍼런스에서 확인하세요.