MiniMax H3 Edit 소개
MiniMax H3 Edit는 업로드한 클립의 조명, 날씨, 스타일, 배경을 바꿔요. 누가 나오는지, 구도와 움직임은 원본 영상이 그대로 유지해요. 3~15초를 480p, 540p 또는 768p로 편집하며, 기본으로 새 사운드트랙을 더해요.
POST /jobs/createTask에서 모델 이름을 minimax/h3-edit/video-edit(으)로 지정하면 호출할 수 있습니다. US$0.15부터.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21 |
duration_seconds | 아니요 | 클립 길이. 초 단위로 요금이 붙습니다. ≥ 3 · ≤ 15 · 기본값: 5 |
generate_audio | 아니요 | 화면에 맞는 소리(목소리, 주변음, 효과음)를 더합니다. 기본값: true |
prompt | 예 | The change to make: lighting, weather, style, setting or specific elements. Name references as <Picture 1> or <Audio 1>. |
reference_audio_urls | 아니요 | 맞출 소리: 목소리, 음악, 리듬. |
reference_image_urls | 아니요 | 결과에 그대로 남길 인물, 의상, 장소의 참조 이미지. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 480p · 540p · 768p · 기본값: 768p |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
video_url | 예 | 작업할 영상. |
가격
요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
| 옵션 | USD /초 |
|---|---|
| resolution 480p | US$0.03 |
| resolution 540p | US$0.045 |
| resolution 768p | US$0.066 |
실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.
API 빠른 시작
MiniMax H3 Edit API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
- 요청 보내기. POST /jobs/createTask에 model은 minimax/h3-edit/video-edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-edit/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "768p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
MiniMax H3 Edit API 질문
MiniMax H3 Edit API 요금은 얼마인가요?
MiniMax H3 Edit 가격은 US$0.15 / 5초 영상입니다. 옵션별 가격: 480p US$0.03/초, 540p US$0.045/초, 768p US$0.066/초. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
API에서 MiniMax H3 Edit의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 영상 편집: minimax/h3-edit/video-edit을(를) 넣으세요.
문장 한 줄로 AI 영상을 편집하려면 어떻게 하나요?
클립을 올리고, 변경 내용을 한 문장으로 쓴 뒤, 그대로 유지할 것을 이어서 적으세요. 요청 한 번이면 변경을 적용한 샷의 새 버전이 돌아옵니다.
인물과 움직임은 그대로 유지되나요?
원본 클립이 샷 속 인물, 구도, 움직임을 정하므로 그대로 이어집니다. 다만 프롬프트가 움직임을 설명하면 작은 동작 변화가 여전히 나타날 수 있으니, 날씨와 빛을 설명하고 동작은 원본에 맡기세요.
편집이 아니라 새 클립을 만들고 싶다면요?
MiniMax H3 (/models/minimax-h3)를 사용하세요. 작성한 장면, 시작 이미지 또는 참조 이미지에서 시작합니다. 이미 가진 영상이 다르게 보이길 원한다면 MiniMax H3 Edit를 사용하세요.
MiniMax H3 Edit API의 제한은 무엇인가요?
영상 길이: 3–15 s; 해상도: 480p · 540p · 768p; 화면 비율: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21; 참조 오디오: 3; 참조 이미지: 9. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 MiniMax H3 Edit을(를) 써 볼 수 있나요?
API 키 없이 Playground에서 API 달러 잔액으로 MiniMax H3 Edit을(를) 실행할 수 있습니다. 실행마다 해당 코드와 함께 개발자 기록에 저장됩니다.
모든 MiniMax 모델
Kling O3도 클립을 편집하며 최대 4K까지 지원해요. 스타일 변경이나 날씨 변경에는 H3 Edit이 더 빠르고 저렴한 선택이에요.
- MiniMax H3 API소리 있는 표현력 있는 클립, 최대 30초 또는 2KUS$0.125부터 / 5초 영상
- MiniMax Speech 2.8 HD API400가지 이상 목소리의 고음질 음성, 감정 조절US$0.12부터 /1,000자
- MiniMax Music 3.0 API보컬 또는 연주곡으로 완성된 스테레오 곡US$0.18부터 /회
- MiniMax H3 Singularity LoRA API커뮤니티 튜닝 H3 영상, 내 LoRA 불러오기US$0.30부터 / 5초 영상
- MiniMax H3 Max API앰비언스·효과음·음악까지 담은 빠른 클립US$0.25부터 / 5초 영상
- MiniMax H3 LoRA API사운드 포함 MiniMax H3 영상, 내 LoRA 최대 3개US$0.25부터 / 5초 영상
- MiniMax H3 Image LoRA APIH3 스틸과 편집, 내 LoRA 최대 3개US$0.042부터 /장
- MiniMax H3 Edit API클립의 조명, 날씨, 스타일을 바꿔요. 인물과 움직임은 그대로US$0.15부터 / 5초 영상
- MiniMax Speech 2.8 Turbo API400가지 이상 목소리의 빠른 음성, 감정 조절US$0.072부터 /1,000자
- MiniMax H3 360 Orbit API사진 한 장의 피사체 주위를 카메라가 360° 회전US$0.25부터 / 5초 영상