P-Video 2 Pro Replace 시작 가이드: 사진 1–2장으로 영상 속 인물 바꾸기

P-Video 2 Pro Replace는 Pruna AI의 영상 인물 교체 모델입니다. 소스 영상과 인물 사진 1–2장을 입력하면 원본 영상의 동작, 카메라 움직임, 장면, 소리를 유지한 채 화면 속 인물을 사진 속 인물로 바꿉니다. 이 글에서는 무엇을 할 수 있는지, 어떻게 호출하는지, 요금은 어떻게 계산되는지, 그리고 언제 다른 모델을 선택해야 하는지 설명합니다.

할 수 있는 일

• 영상 하나와 사진 한 장으로 인물 교체: 필수 입력은 소스 영상 video_url과 인물 사진 image_urls뿐이며, 사전에 인물을 학습시킬 필요가 없습니다.
• 최대 두 명까지 교체: image_urls에 사진 1–2장(jpg, jpeg, png, webp)을 넣습니다. 한 명이면 한 장, 두 명이면 각각 한 장씩 넣습니다.
• 원본 영상의 요소 유지: 동작, 카메라 움직임, 장면, 길이가 모두 소스 영상을 따릅니다. keep_audio는 기본적으로 켜져 있어 출력에 원본 영상의 소리가 포함되며, false로 설정하면 원본 소리가 빠집니다.
• 5단계 해상도: 480p, 768p, 1080p, 2k, 4k이며 기본값은 768p이고 소스 영상의 화면 비율을 유지합니다.
• 선택적 프롬프트: prompt(최대 1000자)로 사진 속 인물을 화면에 어떻게 배치할지 설명할 수 있으며, 작성하지 않아도 생성됩니다.

입력 요구사항

• 소스 영상: MP4, MOV 또는 WebM, 길이 2–30초. 범위를 벗어난 영상은 제출 시 거부되며 요금이 부과되지 않습니다. 더 긴 소재는 먼저 30초 이내의 클립으로 잘라 주세요.
• 인물 사진: 1–2장, HTTPS 링크.
• 콘텐츠 안전 필터는 기본적으로 켜져 있으며, 규정을 위반한 콘텐츠는 실패 처리되고 CONTENT_POLICY_VIOLATION을 반환하며 비용은 전액 환불됩니다.

호출 방법

비동기 작업을 제출하고 taskId를 받은 뒤 결과를 폴링합니다:

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "p-video-2-pro-replace",
    "input": {
      "video_url": "https://example.com/source.mp4",
      "image_urls": ["https://example.com/person.jpg"],
      "resolution": "768p",
      "keep_audio": true
    }
  }'

curl https://api.hiapi.ai/v1/tasks/<taskId> \
  -H "Authorization: Bearer $HIAPI_KEY"

작업이 성공하면 output에 영상 주소가 담기며, 길이는 소스 영상과 같습니다.

가격

출력 영상 길이를 기준으로 과금되며 1초 미만 부분은 청구되지 않습니다. 사진을 1장 넣든 2장 넣든 가격은 같습니다:

• 480p: 초당 $0.0358
• 768p: 초당 $0.0715
• 1080p: 초당 $0.0858
• 2k: 초당 $0.1000
• 4k: 초당 $0.1286

예를 들어 10초 768p 영상은 약 $0.72, 30초 480p는 약 $1.07입니다. 제출 시에는 먼저 30초 기준으로 선차감하고, 완료 후 실제 영상 길이로 정산하여 초과 차감된 금액은 환불됩니다. 실패한 작업은 전액 환불됩니다.

더 잘 활용하는 방법

• 소스 영상 속 인물이 선명하고 동작이 자연스러우며, 사진의 정면 얼굴이 또렷하고 조명이 고르면 교체 결과가 더 안정적입니다.
• 먼저 480p의 짧은 클립으로 효과를 확인한 뒤 고해상도로 최종 영상을 만드세요.
• 결과를 고정하고 싶으면 seed(0–2147483647의 정수)를 전달하세요. 동일한 입력과 함께 사용하면 재현에 도움이 됩니다.

다른 모델을 선택할 때

• 화면 스타일, 장면, 카메라를 바꾸고 싶다면 이 모델은 인물만 교체하고 나머지는 소스 영상을 따르므로, 영상 편집 계열 모델을 선택하세요.
• 소스 영상 없이 인물 사진 한 장과 대사만 있다면 같은 시리즈의 P-Video 2 Pro Avatar로 립싱크 영상을 생성하세요.

바로 효과를 시험해 보려면 HiAPI Playground에서 짧은 영상과 인물 사진을 업로드하여 생성할 수 있습니다.