소개
필수 MP4이며 최대 15초의 연속 장면을 사용합니다. 바꿀 사람은 첫 프레임에 보여야 합니다. 필수 배열에 사진, 일러스트 또는 3D 렌더 1~4장을 넣습니다. 한 장이 한 명을 담당하며 전신 이미지를 권장합니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 제작사 | ComfyUI |
| 엔드포인트 | video-edit |
| 원본 영상 | 연속 장면, 최대 15초 |
| 해상도 | 480p / 540p / 768p(기본) / 1080p |
| 오디오 | 원본 오디오 유지 |
| 실행 | 비동기, 원본 초 단위 요금 |
핵심 기능 및 하이라이트
이미지 순서를 배역 지정에 활용합니다
두 자전거 이용자 테스트에서는 첫 번째 참조를 왼쪽 파란 셔츠 인물에, 두 번째 참조를 오른쪽 빨간 셔츠 인물에 배정했습니다. 이미지 순서대로 인물 설명을 프롬프트의 각 줄에 적어야 합니다. 군중 전체가 달라졌다는 이유로 성공을 판단하지 말고 각 인물의 배정을 따로 확인해야 합니다.
얼굴과 함께 전신 윤곽을 확인합니다
스튜디오 테스트에서는 촬영된 성인 댄서를 빨간 머리의 만화풍 여성 영웅으로 바꿨습니다. 원본 자세를 바탕으로 움직임이 이어지며 머리와 의상이 전신에 걸쳐 달라집니다. 얼굴만 보고 판단하지 말고 움직이는 소매, 허리선, 머리카락도 살펴야 합니다.
짧은 영상도 끝부분까지 검토합니다
같은 두 자전거 이용자 테스트의 3초 시점을 다시 비교합니다. 새 인물뿐 아니라 자전거, 간격, 거리를 살핀 뒤 끝까지 재생해야 합니다. 이 5초 원본에서는 약 4.5초 결과가 나왔습니다. 길이가 같아 보이게 미리보기를 늘리지 말고 실제 결과 길이로 편집을 계획해야 합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 필수 MP4이며 최대 15초의 연속 장면을 사용합니다. 바꿀 사람은 첫 프레임에 보여야 합니다. 1자 이상 |
reference_image_urls | 예 | 필수 배열에 사진, 일러스트 또는 3D 렌더 1~4장을 넣습니다. 한 장이 한 명을 담당하며 전신 이미지를 권장합니다. 1개 이상 · 4개 이하 |
prompt | 아니요 | 이미지 순서대로 한 줄에 한 사람의 위치와 외형을 적습니다. 생략하면 한 장은 주요 인물, 여러 장은 등장 순서로 대응하며 동시 등장은 왼쪽부터 처리합니다. 600자 이하 |
resolution | 아니요 | 480p, 540p, 768p, 1080p이며 기본은 768p입니다. 높은 단계일수록 초당 요금이 오릅니다. |
seed | 아니요 | 선택 정수이며 범위는 0~2147483647입니다. 같은 난수원으로 입력 하나씩 바꿔 비교할 수 있지만 프레임별 일치를 보장하지 않습니다. |
요금
인물 교체는 원본 초수를 올림해 최소 3초로 청구합니다. 선택 해상도가 단가를 결정하며 참조 이미지 비용은 별도로 없습니다. 실패는 청구하지 않고 15초 초과는 과금 전에 거절합니다.
| 사양 | 요금 |
|---|---|
| $0.105 / 초 |
| $0.119 / 초 |
| $0.14 / 초 |
| $0.28 / 초 |
활용 사례
단편 배역 구상
동의받은 배우의 연기로 다른 배역을 검토합니다.
여러 인물 재배치
자전거를 타는 두 사람에게 서로 다른 이미지를 배정합니다.
그림 속 인물 활용
만화나 3D 캐릭터를 성인 출연자의 동작에 적용합니다.
광고와 소셜 영상
같은 촬영 동선에서 가상 출연자별 결과를 비교합니다.
프롬프트 가이드 및 실전 팁
사용 권한부터 확인합니다
모든 인물이 18세 이상이며 영상과 얼굴 사용에 동의했는지 확인합니다. 본인, 서면 동의를 받은 배우 또는 직접 생성한 가상 인물을 사용합니다.
이미지와 대상을 맞춥니다
전신 이미지 1~4장을 준비하고 같은 순서로 한 줄에 한 명씩 교체할 대상을 적습니다.
완성본을 검토합니다
해상도를 선택해 실행한 뒤 얼굴, 옷, 동작과 길이를 확인하고 공개합니다.
소개
필수 MP4이며 최대 15초의 연속 장면을 사용합니다. 바꿀 사람은 첫 프레임에 보여야 합니다. 필수 배열에 사진, 일러스트 또는 3D 렌더 1~4장을 넣습니다. 한 장이 한 명을 담당하며 전신 이미지를 권장합니다.
처리 방식
openjutsu/character-swap/video-edit에 공개 입력을 보내고 반환된 작업 ID를 저장합니다. 성공 또는 실패까지 상태를 폴링한 뒤 성공한 작업의 결과 에셋에서 영상을 가져옵니다. 인물 교체 실측 시간은 1~4분입니다.
매개변수
video_url: 필수 MP4이며 최대 15초의 연속 장면을 사용합니다. 바꿀 사람은 첫 프레임에 보여야 합니다.reference_image_urls: 필수 배열에 사진, 일러스트 또는 3D 렌더 1~4장을 넣습니다. 한 장이 한 명을 담당하며 전신 이미지를 권장합니다.- prompt: 이미지 순서대로 한 줄에 한 사람의 위치와 외형을 적습니다. 생략하면 한 장은 주요 인물, 여러 장은 등장 순서로 대응하며 동시 등장은 왼쪽부터 처리합니다. 없는 대상은 무시하고 지정하지 않은 사람은 남깁니다.
- resolution: 480p, 540p, 768p, 1080p이며 기본은 768p입니다. 높은 단계일수록 초당 요금이 오릅니다. 가로 실측값은 864×480, 960×544, 1376×768, 1920×1056입니다.
- seed: 선택 정수이며 범위는 0~2147483647입니다. 같은 난수원으로 입력 하나씩 바꿔 비교할 수 있지만 프레임별 일치를 보장하지 않습니다.
요금
인물 교체는 원본 초수를 올림해 최소 3초로 청구합니다. 선택 해상도가 단가를 결정하며 참조 이미지 비용은 별도로 없습니다. 실패는 청구하지 않고 15초 초과는 과금 전에 거절합니다.
활용 팁
전신 이미지와 명확한 대상 행으로 대응을 지정합니다. 다른 길이에서 일반 오류가 발생하면 원본을 정수 초로 자르고 재시도하며 옷도 확인합니다.
제한
- 본인 또는 동의한 성인의 얼굴만 사용해야 합니다. 유명인, 지인, 인터넷 사진도 허락 없이는 사용할 수 없으며 실제 인물을 동의하지 않은 장면에 넣어서는 안 됩니다.
- 원본은 15초 이하의 연속 MP4 장면이어야 하며 교체 대상은 첫 프레임에 보여야 합니다. 중간에 컷이 바뀌는 영상은 지원하지 않습니다.
- 의상이 참조 이미지와 같다고 보장하지 않습니다. 성인 여성 사진을 쓴 테스트에서는 원래 옷 대신 흰색 긴 드레스로 바뀌었습니다.
- 인물 교체에서는 약 5.17초(5.13~5.20초) 원본의 시작 부분 약 4프레임을 처리 전에 자동으로 제거해 정확히 5초로 맞춥니다. 직접 자를 필요가 없으며 5초 요금만 청구하고 6초분으로 미리 확보한 금액 중 1초분은 돌려드립니다. 다른 길이의 원본이 일반 오류로 실패하면 정확한 정수 초로 잘라 다시 시도합니다. 인물 교체에 실패한 작업은 무료입니다.
- 5초 원본은 약 4.5초, 8초 원본은 8초로 출력됐습니다. 사용 전에 길이를 확인해야 합니다.
본인 또는 동의한 사람의 얼굴만 사용하고 모든 소재의 등장인물이 18세 이상인지 확인해야 하며, 공개 사진은 허락을 뜻하지 않습니다. 사칭하거나 오해를 유발해서는 안 되며 실제 인물을 동의하지 않은 장면에 넣어서는 안 됩니다. 웹 첫 사용 전에 규칙 동의란을 반드시 체크해야 하고 API 호출도 같은 규칙을 수락한 것으로 간주합니다. 위반 콘텐츠는 삭제되며 계정이 정지될 수 있습니다.
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": "comfyui/openjutsu-character-swap/video-edit",
"input": {
"reference_image_urls": [
"https://example.com/reference.png"
],
"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 레퍼런스에서 확인하세요.




