소개
P-Video 2 Pro 레퍼런스→영상은 업로드한 레퍼런스로 480p 또는 768p의 5~15초 클립을 만듭니다. 움직임, 카메라, 리듬을 위한 레퍼런스 영상은 최대 3개(총 15초), 목소리, 대사, 음악을 위한 오디오 클립은 최대 3개, 그리고 선택적인 첫 프레임과 마지막 프레임을 받습니다. 프롬프트에서는 업로드 순서대로 클립을 video 1, video 2와 audio 1, audio 2로 지칭하십시오. 콘텐츠 필터는 없습니다.
시작 소재에 따라 P-Video 2 Pro 모드 고르기
| 시작할 때 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면이나 대본 | P-Video 2 Pro 텍스트→영상 |
| 첫 프레임, 그리고 선택적으로 마지막 프레임 | P-Video 2 Pro 이미지→영상 |
| 동작을 빌려 올 클립, 또는 음성이나 음악 트랙 | P-Video 2 Pro 레퍼런스→영상 (현재 보고 계신 곳) |
핵심 기능 및 하이라이트
카메라 움직임 빌리기
레퍼런스 영상은 움직임과 리듬을 넘겨줍니다. 이를 첫 프레임과 결합하면 나만의 캐릭터를 그 움직임 안에 넣을 수 있습니다.
직접 준비한 오디오 쓰기
목소리 대사나 음악 클립을 audio 1로 추가하십시오. keep_reference_audio를 켜고 오디오 클립이 정확히 하나이면 그 클립이 사운드트랙이 됩니다. 끄면 클립은 소리의 방향만 안내하고 모델이 새 오디오를 생성합니다. 오디오에도 첫 프레임이나 레퍼런스 영상이 함께 필요합니다.
시작과 끝 고정하기
image_url과 last_image_url도 레퍼런스 클립과 함께 그대로 작동합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 각 레퍼런스에서 무엇을 가져올지 말하십시오. 레퍼런스 영상은 video 1, video 2로, 오디오 클립은 audio 1, audio 2로 업로드 순서에 따라 지칭하십시오. 1자 이상 |
image_url | 아니요 | 선택적인 첫 프레임: 샷이 어디서 누구로 시작하는지 정합니다. 소액이 추가됩니다. |
last_image_url | 아니요 | 선택적인 마지막 프레임: 클립이 끝나는 지점입니다. 소액이 추가됩니다. |
reference_video_urls | 아니요 | 최대 3개, 각각 2초 이상, 총 15초까지 가능하며 움직임, 카메라, 리듬을 위한 것입니다. 그 초 수가 요금에 청구되며, 반올림을 위해 1초가 더해집니다. 1개 이상 · 3개 이하 |
reference_audio_urls | 아니요 | 최대 3개 오디오 클립, 총 15초, 목소리, 대사 또는 음악을 위한 것입니다. 첫 프레임 또는 레퍼런스 영상도 함께 필요합니다. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 레퍼런스를 따릅니다. 또는 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 1:1 중에서 고르십시오. |
resolution | 아니요 | 480p 또는 768p(기본값 768p). 768p는 초당 요금이 더 비쌉니다. |
generation_mode | 아니요 | cost(더 저렴하고 조금 느림) 또는 speed(기본값, 같은 화질에서 더 빠름). |
keep_reference_audio | 아니요 | 기본값은 끔입니다. 켜면 새 사운드를 생성하는 대신 오디오 클립을 사운드트랙으로 씁니다. 기본값: |
duration_seconds | 아니요 | 정수 초, 5~15(기본값 5). 요금을 결정합니다. |
prompt_optimization_mode | 아니요 | off(기본값)는 프롬프트를 글자 그대로 보냅니다. turbo와 max는 서비스가 먼저 다시 쓰게 합니다. |
seed | 아니요 | 프롬프트를 바꾸는 동안 실행 결과를 비교할 수 있게 해 줍니다. 프레임이 완전히 같은 클립을 보장하지는 않습니다. |
요금
선택한 해상도와 생성 모드에 따른 출력 1초당 요금, 레퍼런스 영상의 초 수, 반올림을 위한 1초 추가분, 첫 프레임 또는 마지막 프레임마다 소액, 레퍼런스 오디오를 추가하면 정액이 청구됩니다. 실패한 요청에는 요금이 청구되지 않습니다.
| 해상도 | Generation mode: cost | Generation mode: speed |
|---|---|---|
| $0.018 / 초 | $0.024 / 초 |
| $0.03 / 초 | $0.042 / 초 |
활용 사례
새 피사체로 샷 재연하기
카메라 움직임이 마음에 드는 클립과 캐릭터의 첫 프레임을 올리면, 결과물은 그 움직임을 따르되 피사체는 내 캐릭터가 됩니다.
입 모양을 맞춘 대사
인물 사진을 첫 프레임으로, 짧은 음성 클립을 audio 1로 주고 keep_reference_audio를 켠 뒤 샷에서 일어날 일을 적으십시오.
음악 중심 클립
음악 클립을 audio 1로 쓰면 움직임의 분위기와 리듬이 정해집니다.
프롬프트 가이드 및 실전 팁
각 레퍼런스의 용도를 말하십시오
‘Follow the camera move of video 1’ 또는 ‘she speaks the line from audio 1’처럼 쓰면 각 클립에서 무엇을 가져올지 모델에 알려 줍니다.
레퍼런스 영상은 잘라 쓰십시오
레퍼런스 영상의 초 수는 요금이 청구되므로, 빌려 올 부분만 남기고 각 클립을 2초 이상으로 잘라 쓰십시오.
프레임은 룩을, 클립은 움직임을 정합니다
첫 프레임은 누가 어디에 있는지를, 레퍼런스 영상은 사물이 어떻게 움직이는지를 정합니다. 레퍼런스에 맞추려면 aspect_ratio를 auto로 두십시오.
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/reference-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"generation_mode": "speed",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"prompt_optimization_mode": "off",
"resolution": "768p"
}
}'
# 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 레퍼런스에서 확인하세요.



