MiniMax H3 Edit API

MiniMax H3 영상 편집은 이미 가진 클립을 video_url로 보내고, 변경 내용을 설명하는 프롬프트를 함께 받아 같은 샷의 새 버전을 돌려줍니다. 해상도는 480p·540p·768p 중에서 고르고, 길이는 3~15초이며, 기본으로 새 사운드트랙이 생성됩니다. 원본 영상은 화면에 누가 나오는지, 구도와 움직임을 계속 이끌고, 프롬프트는 조명, 날씨, 화풍, 환경이나 특정 요소를 새로 씁니다. 참조 이미지는 최대 9장, 참조 오디오 클립은 최대 3개까지 넣어 인물 정체성, 화풍 또는 소리를 안내할 수 있습니다.

시작 자료에 따라 모드 선택하기

클립이 인물과 움직임을 계속 이끕니다

원본이 샷에 누가 나오는지, 어떻게 프레이밍되는지, 모두가 어떻게 움직이는지를 정합니다. 프롬프트는 그 주변 세계가 어떻게 보일지를 정합니다. 이 분리가 편집과 새 샷 생성을 가릅니다. 장면을 다시 설명할 필요 없이 변경만 적으면 됩니다. 원본은 최대 15초까지 가능하며, 더 긴 클립은 과금되기 전에 거부되므로 먼저 잘라 주세요.

맑은 테라스가 폭풍으로 바뀌다

테스트에는 OmniHuman 2.0 예시에서 가져온 5초짜리 1280x720 클립을 썼습니다. 햇살 가득한 해변 테라스에서 크림색 새틴 트렌치코트를 입은 여성입니다. 프롬프트는 먹구름, 비, 바람에 날리며 젖은 머리카락과 코트, 멀리서 번쩍이는 번개가 있는 폭풍이 몰아치는 저녁을 요청했고, 마지막에 ‘Keep her face, pose and movement.’로 끝냈습니다. 768p, duration_seconds 5, 사운드 켜짐으로 실행한 결과는 24fps의 1344x768 클립이었습니다. 길이는 약 5.2초였고 새 사운드가 입혀졌으며, 처리에는 약 3분이 걸렸습니다.

바뀐 점은 맑던 하늘이 바다 위로 번개가 번쩍이는 어둡고 흐린 저녁이 되었고, 돌은 젖은 듯 보인다는 것입니다. 유지된 점은 얼굴, 코트, 미소입니다. 솔직히 말씀드리면 미리 알아 두실 점이 두 가지 있습니다. 768p에서 비 자체는 약했고, 같은 프롬프트의 480p 시험에서는 빗줄기가 더 강하게 나왔습니다. 또 여성이 바람에 날리는 머리카락 쪽으로 손을 들어 올렸는데, 이는 원본 클립에 없던 동작입니다. 프롬프트가 바람에 날리는 머리카락을 요청했기 때문에, 움직임을 설명하면 작은 동작 변화가 함께 따라올 수 있습니다.

참조는 번호로 부릅니다

reference_image_urls는 이미지를 최대 9장까지 받아 프롬프트에서 <Picture 1>부터 <Picture 9>까지로 부르고, reference_audio_urls는 오디오 클립을 최대 3개까지 받아 <Audio 1>부터 <Audio 3>까지로 부릅니다. 이미지는 화풍이나 인물 정체성에, 오디오 클립은 원하는 소리에 연결하세요. 참조 하나마다 소액의 요금이 추가됩니다. 아직 이 엔드포인트를 참조와 함께 돌려 보지 않았으니, 참조를 넣은 첫 테이크는 시험으로 보십시오. 이미지 한 장이나 클립 하나로 시작해 무엇이 바뀌는지 확인하십시오.

사운드, 길이, 화면비

generate_audio는 기본으로 켜져 있어 편집 결과에 새 사운드트랙이 입혀집니다. 끄면 원본 클립의 오디오 트랙을 유지합니다. 사운드는 요금을 바꾸지 않습니다. duration_seconds는 3~15초 범위이며 기본값은 5초이므로, 클립 전체를 편집하려면 원본 길이로 설정하세요. aspect_ratio를 비워 두면 편집 결과가 원본의 화면비를 유지하고, 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 또는 9:21로 설정하면 화면비를 바꿉니다.

해상도 세 가지

768p가 기본값이며 H3의 네이티브 출력 해상도입니다. 540p와 480p는 초당 요금이 적고 더 빨리 끝납니다. 768p와 480p 시험은 진행했고, 540p는 아직 시험하지 않았습니다. 요금은 편집 결과의 초와 원본의 초를 더해 계산하며 둘 다 선택한 해상도의 단가가 적용되므로, 원본이 짧을수록 요금이 적게 듭니다.

날씨, 빛, 시간대 바꾸기

밝은 오후를 저녁으로 바꾸거나, 비를 더하거나, 한낮의 강한 햇빛을 부드러운 아침 빛으로 바꿀 수 있습니다. 테라스 예시가 그런 경우입니다. 인물과 움직임은 클립에서 오므로, 다시 촬영하지 않고 한 테이크에서 여러 분위기를 시험해 볼 수 있습니다.

완성한 클립의 스타일 바꾸기

다른 스타일, 계절이나 배경을 요청하면서 연기는 그대로 둘 수 있습니다. 얼굴, 자세, 움직임처럼 유지할 것을 이름으로 적으세요. 지금까지 시험한 것은 날씨와 빛입니다. 스타일과 배경 변경은 이 엔드포인트의 목적에 맞지만, 의존하기 전에 초안을 확인하십시오.

요소 하나만 바꾸기

코트 색이나 장면 속 소품처럼 특정 요소를 프롬프트에서 겨냥하고, 나머지는 그대로 둔다고 적으세요. 먼저 초안을 돌려 요청하지 않은 부분이 바뀌었는지 확인하십시오.

# 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-edit/video-edit",
  "input": {
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "768p",
    "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 레퍼런스에서 확인하세요.