소개
필수 원본 영상이며 컷 없이 최대 15초입니다. 입력 길이가 요금을 결정하고 원본 소리를 유지합니다. 기본 change는 대상을 바꾸고 background는 대상을 남기며 주변을 교체합니다. 사람을 남기려면 people을 지정합니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 제작사 | ComfyUI |
| 엔드포인트 | video-edit |
| 원본 영상 | 컷 전환 없이 최대 15초 |
| 해상도 | 480p / 540p / 기본 768p / 1080p |
| 오디오 | 입력 음성 트랙 보존 |
| 실행 | 비동기 작업, 입력 길이 기준 청구 |
핵심 기능 및 하이라이트
머리색과 길이를 따로 판단합니다
온실 테스트에서는 짧은 백금색 금발을 요청했습니다. 결과는 색을 바꿨지만 원래의 곱슬 형태와 길이는 상당 부분 유지했습니다. 염색이 잘됐다는 이유로 요청한 커트까지 구현됐다고 볼 수 없으므로 각 속성을 따로 검토해야 합니다.
편집 대상 옆의 인물도 살핍니다
와인 저장고 테스트에서는 blouse를 대상으로 지정하고 흰색 리넨 셔츠를 요청했습니다. 여성의 옷을 옆의 남성과 들어 올린 잔까지 함께 비교해야 합니다. 선택하지 않은 모든 픽셀이 같다고 가정하지 않고 의상 편집 범위를 확인하는 비교입니다.
배경을 바꿀 때는 남길 대상을 지정합니다
background 모드에서는 people을 보존할 대상으로 두고 프롬프트에 야간 옥상 테라스를 설명합니다. 저장고 예시는 두 사람과 잔을 남긴 채 주변을 도시 불빛으로 바꿨습니다. 인물 윤곽과 팔 주변처럼 기존 배경과 새 배경이 맞닿는 부분을 확인해야 합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 필수 원본 영상이며 컷 없이 최대 15초입니다. 입력 길이가 요금을 결정하고 원본 소리를 유지합니다. 1자 이상 |
edit_target | 예 | hair, jacket, car처럼 보이는 대상을 짧게 적습니다. 여러 개는 쉼표로 나누며 background에서는 남길 대상을 뜻합니다. 1자 이상 · 120자 이하 |
edit_mode | 아니요 | 기본 change는 대상을 바꾸고 background는 대상을 남기며 주변을 교체합니다. 사람을 남기려면 people을 지정합니다. |
prompt | 아니요 | 변경 후 모습이나 background에서 새 장소를 적습니다. reference_image_url과 둘 중 하나 이상을 제공하며 함께 쓸 수도 있습니다. 600자 이하 |
reference_image_url | 아니요 | 옷, 머리, 상품, 장소를 위한 선택 참조입니다. 단품 사진과 설명을 권장하며 사람 전체 사진은 의상을 재현하지 못한 사례가 있습니다. 1자 이상 |
resolution | 아니요 | 480p, 540p, 기본 768p, 1080p를 고릅니다. 단계가 높으면 단가도 오릅니다. |
seed | 아니요 | 0~2147483647 범위의 선택 정수입니다. 같은 난수원을 써서 설정 하나씩 비교할 수 있으나 프레임 단위 재현을 약속하지 않습니다. |
요금
물건 편집은 입력 초수를 올림하고 최소 3초로 청구합니다. 해상도가 초당 단가를 바꾸며 이미지 참조는 별도 요금이 없습니다. 실패는 무료이고 15초가 넘으면 과금 전에 거절합니다.
| 사양 | 요금 |
|---|---|
| $0.105 / 초 |
| $0.119 / 초 |
| $0.14 / 초 |
| $0.28 / 초 |
활용 사례
의상 후보 비교
허락받은 성인 영상에 가죽 재킷이나 리넨 셔츠를 적용합니다.
머리색 실험
플래티넘 색상을 시도하고 원래 길이와 곱슬이 남는지 확인합니다.
건배 장소 이동
두 사람과 잔을 남기고 와인 저장고를 밤의 옥상으로 바꿉니다.
브랜드 상품 구상
단품 참조와 설명으로 교체를 시도하고 광고에 쓰기 전에 결과를 검토합니다.
프롬프트 가이드 및 실전 팁
소재 이용 동의를 확인합니다
사진과 영상, 얼굴의 사용 허가를 확인하고 등장인물이 모두 18세 이상인지 점검합니다.
대상과 모드를 고릅니다
edit_target에 화면 속 모습을 짧게 적습니다. change는 교체하고 background는 지목한 요소를 남깁니다.
원하는 모습을 설명합니다
prompt나 reference_image_url을 제공합니다. 배경 모드는 새 장소를 적으며 옷은 단품 이미지와 설명을 함께 쓰는 편을 권장합니다.
결과의 세부를 확인합니다
짧은 영상으로 실행하고 완료된 영상의 대상, 주변, 소리를 검토합니다.
소개
필수 원본 영상이며 컷 없이 최대 15초입니다. 입력 길이가 요금을 결정하고 원본 소리를 유지합니다. 기본 change는 대상을 바꾸고 background는 대상을 남기며 주변을 교체합니다. 사람을 남기려면 people을 지정합니다.
처리 방식
openjutsu/object-swap/video-edit를 호출하고 작업 식별자를 저장합니다. 최종 상태까지 폴링한 후 성공한 작업의 결과 에셋에서 편집 영상을 얻습니다. 편집에 사용하기 전에 출력물을 검토합니다.
매개변수
video_url: 필수 원본 영상이며 컷 없이 최대 15초입니다. 입력 길이가 요금을 결정하고 원본 소리를 유지합니다.edit_target: hair, jacket, car처럼 보이는 대상을 짧게 적습니다. 여러 개는 쉼표로 나누며 background에서는 남길 대상을 뜻합니다.edit_mode: 기본 change는 대상을 바꾸고 background는 대상을 남기며 주변을 교체합니다. 사람을 남기려면 people을 지정합니다.- prompt: 변경 후 모습이나 background에서 새 장소를 적습니다. reference_image_url과 둘 중 하나 이상을 제공하며 함께 쓸 수도 있습니다.
reference_image_url: 옷, 머리, 상품, 장소를 위한 선택 참조입니다. 단품 사진과 설명을 권장하며 사람 전체 사진은 의상을 재현하지 못한 사례가 있습니다.- resolution: 480p, 540p, 기본 768p, 1080p를 고릅니다. 단계가 높으면 단가도 오릅니다. 가로 실측 크기는 864×480, 960×544, 1376×768, 1920×1056입니다.
- seed: 0~2147483647 범위의 선택 정수입니다. 같은 난수원을 써서 설정 하나씩 비교할 수 있으나 프레임 단위 재현을 약속하지 않습니다.
요금
물건 편집은 입력 초수를 올림하고 최소 3초로 청구합니다. 해상도가 초당 단가를 바꾸며 이미지 참조는 별도 요금이 없습니다. 실패는 무료이고 15초가 넘으면 과금 전에 거절합니다.
활용 팁
기존 요소의 이름과 원하는 새 모습을 분리해 적습니다. 참조는 단품 이미지와 글을 권장합니다. 다른 길이에서 일반 오류가 발생했다면 원본을 정수 초 길이로 다듬어 재시도합니다.
제한
- 물건만 바꾸더라도 본인이나 동의한 성인의 얼굴만 사용합니다. 유명인, 지인, 온라인 사진은 공개돼 있다는 이유로 허용되지 않으며 사칭과 오해 유발은 금지합니다.
- 입력은 최대 15초의 단일 연속 촬영이어야 합니다. 여러 컷을 붙인 영상은 나눠서 제출해야 합니다.
- 머리 테스트는 색상만 플래티넘으로 바뀌고 짧게 해 달라는 요청에도 길이와 곱슬이 유지됐습니다. 모양보다 색을 바꾸기 쉬울 수 있습니다.
- 사람 전체 사진만 준 한 번의 참조 테스트에서는 의상이 재현되지 않았습니다. 단품 이미지와 명확한 설명을 권장하지만 보장된 방법은 아닙니다.
- 물건 편집 시 약 5.17초(5.13~5.20초) 소재는 앞부분 약 4프레임이 자동으로 잘려 정확히 5초 길이로 처리됩니다. 수동으로 자르지 않아도 됩니다. 요금은 5초분이며 접수 시 확보한 6초분 중 남는 1초분은 반환합니다. 다른 길이의 소재에서 일반 오류로 편집에 실패하면 정수 초에 정확히 맞춰 자른 뒤 다시 제출합니다. 실패한 물건 편집에는 요금을 부과하지 않습니다.
본인이나 허락한 사람의 얼굴만 업로드하고 모든 소재의 인물이 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-object-swap/video-edit",
"input": {
"edit_mode": "change",
"edit_target": "example",
"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 레퍼런스에서 확인하세요.




