소개
MiniMax H3 Character Swap 영상 편집은 짧은 클립 속 한 사람을 이미지 한 장의 캐릭터로 다시 캐스팅합니다.
핵심 기능 및 하이라이트
- 클립, 캐릭터 이미지, 바꿀 사람을 보냅니다. 플랫폼이 어댑터가 학습된 지시문을 만듭니다(“Replace ... with the character in the picture; keep the reference character's face, hair and clothing; follow the source performance's pose, gaze, expression and movement; preserve the scene and the other people”).
- Character Swap V1.5 어댑터는 강도 1로 불러옵니다.
- 어댑터를 쓰면 교체가 원본 연기를 한 박자씩 따랐습니다. 어댑터 없이 같은 베이스 모델을 쓰면 중간에 연기가 무너졌고, 한 번은 원래 남성이 행인처럼 화면에 남았습니다.
- 두 사람이 나오는 장면에서는 지정한 사람만 바뀌었습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 원본 클립(MP4)입니다. 최대 15초가 사용되며, 컷이 없는 한 테이크가 가장 잘 작동합니다. 1자 이상 |
image_url | 예 | 새 캐릭터 이미지 한 장입니다. 사진, 3D 렌더, 그림 모두 가능합니다. 1자 이상 |
prompt | 아니요 | 누구를 바꿀지 몇 단어로 적습니다. 예: ‘the woman on the left’, ‘the man in the white shirt’. 300자 이하 |
aspect_ratio | 아니요 | 출력 모양입니다(기본 16:9). 원본 클립과 같은 모양을 고르십시오. |
resolution | 아니요 | 480p(기본), 540p, 768p 또는 1080p입니다. 해상도가 높을수록 초당 요금이 높으며, 480p가 교체를 먼저 확인하는 저렴한 방법입니다. |
duration_seconds | 아니요 | 출력 길이는 3~15초입니다(기본 5초). 전체 연기가 쓰이도록 클립 길이에 맞추십시오. |
seed | 아니요 | 입력을 한 번에 하나씩 바꾸면서 실행을 비교할 수 있게 해 줍니다. 프레임까지 똑같은 클립을 보장하지는 않습니다. |
요금
출력 초당과 원본 영상 초당(최대 15초, 시작한 초는 모두 계산)에 따라 과금되며, 캐릭터 이미지에는 소액의 수수료가 붙습니다. 요금은 해상도에 따라 다릅니다.
| 사양 | 요금 |
|---|---|
| $0.06 / 초 |
| $0.09 / 초 |
| $0.12 / 초 |
| $0.24 / 초 |
활용 사례
- 서명된 출연 동의서가 있는 연기자를 같은 테이크에서 다른 모습으로 다시 캐스팅합니다.
- 직접 생성한 가상 캐릭터를 직접 촬영한 실사 영상에 넣습니다.
- 재촬영 전에 의상이나 캐스팅 아이디어를 빠르게 미리 봅니다.
프롬프트 가이드 및 실전 팁
- 만화 그림과 3D 애니메이션 참조는 같은 머리, 색감, 의상을 가진 실사 인물로 나옵니다.
- 일부 결과는 원본 의상이 남거나, 얼굴이 참조에서 벗어나거나, 배경 엑스트라가 추가됩니다. 다른 시드나 다른 클립으로 다시 돌리십시오.
- 사용 권한이 있는 영상과 얼굴만 처리하십시오: 본인, 서명된 출연 동의서가 있는 연기자, 또는 직접 생성한 가상 인물입니다. 그 사람의 명시적이고 충분한 고지를 받은 동의 없이 실존 인물을 친밀하거나 명예를 훼손하는 영상에 넣는 데 쓰지 마십시오. 누구인 척 사칭하는 데에도, 미성년자가 나오는 영상에도 쓰지 마십시오. 사진이 공개되어 있다는 사실은 동의가 아니며, 동의는 프로젝트 사이에서 옮겨지지 않습니다.
API 빠른 시작
# 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-character-swap/video-edit",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"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 레퍼런스에서 확인하세요.
