소개
video_url과 reference_image_urls를 제공하고 480p~4K 중 출력 단계를 선택합니다. 교체 대상을 명시해야 할 때는 prompt를 사용합니다. 자체 테스트 결과는 측정한 원본 길이를 유지한 24 fps MP4로 전달됐습니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 제작사 | Pruna AI |
| 영상 입력 | MP4, MOV 또는 WebM, 최대 8K |
| 원본 길이 | 1–120초, 초과 업로드는 120초에서 자름 |
| 참조 사진 | 1~2장, 사진당 1명 |
| 해상도 단계 | 480p, 768p(기본), 1080p, 2K, 4K. 마지막 3단계는 768p에서 업스케일 |
| 출력 형식과 프레임 속도 | 자체 테스트 기준 MP4, 24 fps |
| 출력 길이와 화면 비율 | 자체 테스트에서 원본 재생 시간과 화면 비율 유지 |
| 소리 | 원본 오디오 기본 유지, 제거 가능. Pruna 설명에 따르면 원본 오디오를 무시하지 않으면 발화 동작이 이를 따름 |
핵심 기능 및 하이라이트
사진마다 교체할 자전거 이용자를 지정합니다
자체 테스트에서는 prompt로 첫 번째 사진을 파란 옷의 자전거 이용자에게, 두 번째 사진을 빨간 옷의 이용자에게 배정했습니다. 결과에는 흰 셔츠의 남성과 갈색 재킷, 카고 바지 차림의 만화 여주인공이 나란히 나타났습니다. 전차와 거리, 카메라 이동은 장면에 유지됐습니다.
솔로 연기의 동작을 그대로 활용합니다
자체 테스트에서는 참조 1장으로 스튜디오 댄서를 짙은 헤어스타일과 검은 셔츠 차림의 여성으로 바꿨습니다. 요청에서 prompt는 비워 두었습니다. 춤 동작은 원본을 따랐으며 회색 스튜디오도 유지됐습니다.
오디오 유지와 소리를 통한 동작 유도를 구분합니다
두 오디오 스위치는 역할이 다릅니다. keep_original_audio는 전달되는 파일에 녹음된 소리를 남깁니다. ignore_source_audio는 모델이 그 녹음을 들을지 결정하며, Pruna 설명에 따르면 소리를 들을 때 교체된 인물의 발화 동작이 이를 따릅니다. 자체 테스트에서 오디오 유지를 끄자 오디오 트랙이 제거됐습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 필수 원본 영상으로 MP4, MOV 또는 WebM을 사용합니다. 길이는 1–120초, 해상도는 최대 8K입니다. 1자 이상 |
reference_image_urls | 예 | 각각 한 사람이 담긴 사진 1~2장이 필수입니다. 사진이 1장이면 주요 인물이 대상이 됩니다. 1개 이상 · 2개 이하 |
prompt | 아니요 | 원본에서 교체할 인물, 사진별 대상, 유지할 요소를 지정하는 선택 지시입니다. 예: ‘첫 번째 사진은 파란 옷의 자전거 이용자에게, 두 번째 사진은 빨간 옷의 이용자에게 적용합니다.’ 인물이 한 명이면 prompt를 비워 둘 수 있습니다. 2000자 이하 |
resolution | 아니요 | 직접 생성하려면 480p 또는 768p(기본)를 선택합니다. 1080p, 2K, 4K는 768p 결과를 업스케일하므로 시간이 더 걸립니다. |
keep_original_audio | 아니요 | 원본 녹음을 유지하도록 기본으로 켜져 있습니다. 자체 테스트에서 이 설정을 끄면 오디오 트랙이 없는 결과가 생성됐습니다. 기본값: |
ignore_source_audio | 아니요 | 모델이 원본 소리를 들을 수 있도록 기본으로 꺼져 있습니다. Pruna 설명에 따르면 이를 통해 교체된 인물의 발화 동작을 유도합니다. 기본값: |
seed | 아니요 | 입력 하나를 바꾸며 비교할 때 사용하는 선택 정수입니다. 같은 값을 재사용해도 모든 프레임이 이전 실행과 일치한다고 보장하지 않습니다. |
요금
원본 영상 길이를 정수 초로 올림해 최소 1초, 최대 120초로 계산합니다. 선택한 해상도가 단가를 결정합니다. 사진 수, prompt 내용, 두 오디오 스위치는 단가에 영향을 주지 않습니다. 실패한 작업에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.06 / 초 |
| $0.12 / 초 |
| $0.144 / 초 |
| $0.168 / 초 |
| $0.216 / 초 |
활용 사례
촬영한 영상에서 배역을 검토합니다
배우의 허락을 받은 교체용 사진을 이미 촬영한 장면에 적용해 기존 연기에서 달라진 외형을 검토합니다.
거리 장면의 두 인물을 바꿉니다
셔츠 색상으로 자전거 이용자를 구분해 참조 사진 2장을 배정하고, 카메라가 이동하는 동안 각 인물이 어떻게 나타나는지 살펴봅니다.
솔로 안무에 캐릭터 스타일을 적용합니다
사용 허가를 받은 캐릭터 참조를 댄서의 스튜디오 영상에 적용하고 안무 전체에서 헤어스타일과 의상을 비교합니다.
프롬프트 가이드 및 실전 팁
동의와 사진 사용 권한을 확인합니다
해당 용도로 초상을 사용하는 데 당사자의 허락을 받고 사진 사용 권한도 확인합니다. 모델 페이지에서 첫 실행 전에 표시되는 동의 안내를 수락합니다.
영상과 교체할 인물 사진을 추가합니다
길이가 1
120초인 MP4, MOV 또는 WebM을 선택합니다. 한 사람씩 담긴 사진을 12장 추가합니다. 사진이 1장이면 주요 인물이 교체 대상이 됩니다.배역을 지정하고 소리를 설정합니다
2명을 교체할 때는 prompt로 원본 인물과 사진을 각각 연결하거나 왼쪽부터 자동 대응합니다. 해상도를 선택하고 소리 유지 여부와 소리에 따른 발화 동작 적용 여부를 정합니다.
결과를 검토하고 저장합니다
교체된 인물의 외형, 연기, 오디오를 원본과 비교합니다. 완성된 파일은 삭제되기 전인 14일 이내에 다운로드합니다.
소개
Pruna AI의 P-Video 2 Pro Replace는 기존 영상과 참조 사진 12장으로 배역을 바꿉니다. 길이 1120초의 MP4, MOV 또는 WebM 영상과 교체할 인물별 사진을 준비합니다. 제출 전에 모든 인물의 초상 사용 동의를 받고 사진 사용 권한을 확인해야 합니다. 유명인, 공인, 지인 또는 사용 권한이 없는 이미지는 사용하지 마십시오. 모델 페이지에서는 첫 실행 전에 동의 안내 수락을 요청합니다.
Pruna 설명에 따르면 편집 시 카메라 이동, 구도, 배경, 다른 인물, 타이밍과 동작을 보존하며 새로운 인물이 원본 연기를 따릅니다. 길이와 화면 비율은 원본에서 결정되며 각각의 별도 설정은 없습니다. 자체 테스트에서 5.04초와 2.00초 입력은 동일한 길이의 24 fps MP4 파일로 반환됐습니다. 참조는 인물의 외모와 함께 의상과 헤어스타일도 바꿀 수 있습니다.
주요 기능과 특징
- 1~2명 교체: 사진 1장은 주요 인물을 대상으로 합니다. 사진 2장은 prompt로 다르게 지정하지 않으면 왼쪽부터 대응합니다.
- 최대 120초 원본: 최대 8K 영상을 입력할 수 있습니다. 120초 지점 이후는 잘립니다.
- 5가지 출력 선택: 480p와 기본값인 768p는 직접 생성합니다. Pruna는 1080p, 2K, 4K에 768p 결과를 업스케일하며, 모델 디테일이 추가되는 대신 처리 시간이 늘어납니다.
- 독립적인 소리 설정: keep_original_audio는 기본으로 오디오를 유지합니다. ignore_source_audio는 기본으로 꺼져 있어 Pruna 설명처럼 모델이 소리를 이용해 발화 동작을 유도할 수 있습니다.
- 그림 참조 테스트: 자체 테스트에서 만화 여주인공의 헤어스타일, 재킷, 카고 바지가 자전거 영상에 반영됐습니다.
- 처리 시간 실측 예시: 자체 테스트에서 2초 원본은 480p에서 47초, 4K에서 160초가 걸렸습니다. 768p의 5초 원본은 60–90초가 걸렸습니다. 이는 관측값이며 완료 시간을 보장하지 않습니다.
활용 사례
- 동의받은 배역 변경 미리보기: 배우가 사용을 허락한 사진을 기존 장면에 적용해 촬영된 연기에서 다른 외형을 검토합니다.
- 자전거 이용자 2명 배정: 사진 2장을 사용하고 셔츠 색상으로 각 대상을 구분합니다. 배정을 비교하면서 거리와 전차가 원본과 같은지 확인합니다.
- 안무에 캐릭터 적용: 솔로 댄서에게 캐릭터 참조 1장을 제공하고 스튜디오 연기 전반에서 바뀐 헤어스타일과 의상을 검토합니다.
prompt 작성 안내와 활용 팁
- 솔로 요청은 간단하게: 화면에 한 명만 있으면 prompt를 비워 둡니다. 이때 적용되는 지시는 ‘주요 인물을 교체합니다’입니다. 자체 솔로 댄스 예시에는 prompt가 필요하지 않았습니다.
- 두 참조를 명확히 배정: ‘파란 셔츠의 자전거 이용자: 첫 번째 사진, 빨간 셔츠의 이용자: 두 번째 사진’처럼 원본 의상과 사진 순서를 명시합니다. 이 지시는 왼쪽부터 자동 대응하는 방식에 우선합니다.
- 유지할 요소 명시: ‘다른 인물과 거리를 그대로 유지합니다’처럼 짧은 지시를 추가합니다. Pruna는 원본 장면을 편집의 바탕으로 설명합니다.
- 오디오 동작은 별도로 선택: ‘대화를 유지하고 그 타이밍을 따릅니다’라는 의도라면 keep_original_audio를 켜고 ignore_source_audio를 끈 상태로 둡니다. 소리는 유지하면서 소리에 따른 발화 동작을 사용하지 않으려면 ignore_source_audio를 켭니다.
- 실행마다 변경은 하나씩 비교: ‘두 번째 사진으로 빨간 옷의 자전거 이용자를 교체합니다’ 같은 지시를 시험할 때 정수 seed를 사용합니다. seed는 조건을 통제한 비교를 돕지만 동일한 프레임을 보장하지는 않습니다.
- 업스케일 선택 전 검토: ‘스튜디오 배경을 보존합니다’ 같은 지시를 기본 768p 결과에서 확인합니다. 업스케일 버전이 필요하고 추가 처리 시간을 확보할 수 있을 때 1080p, 2K 또는 4K를 선택합니다.
제출하는 모든 인물의 초상 사용 허락을 받고 참조 사진의 사용 권한을 확인해야 합니다. 유명인, 공인, 지인 또는 사용 권한이 없는 사진은 사용하지 마십시오. 모델 페이지에서 첫 실행 전에 동의 안내를 수락해야 합니다. 편집된 영상을 소개할 때는 사실대로 설명합니다.
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": "pruna-ai/p-video-2-pro-replace/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 레퍼런스에서 확인하세요.

