소개
P-Video 2 Pro 토킹 아바타는 인물 사진(image_url)과 말하기 또는 노래를 담은 녹음(audio_url)을 받아, 그 인물이 녹음을 전달하는 클립을 돌려줍니다. 입, 얼굴, 머리가 오디오에 맞춰 움직이며, 보내신 녹음이 그대로 사운드트랙이 됩니다. 길이를 정하는 필드는 없습니다. 오디오가 길이를 정하며, 1초에서 180초 사이입니다. 선택 입력인 prompt로 움직임, 표정, 구도를 지시할 수 있으며, 어떤 것도 필터링되지 않습니다.
시작 소재에 따라 P-Video 2 Pro 모드 고르기
| 시작할 때 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면이나 대본 | P-Video 2 Pro 텍스트→영상 |
| 첫 프레임, 그리고 선택적으로 마지막 프레임 | P-Video 2 Pro 이미지→영상 |
| 동작을 빌려 올 클립, 또는 음성이나 음악 트랙 | P-Video 2 Pro 레퍼런스→영상 |
| 인물 사진과 그 사람이 말할 녹음 | P-Video 2 Pro 토킹 아바타 (현재 보고 계신 곳) |
핵심 기능 및 하이라이트
녹음이 클립을 이끕니다
저희 실행에서 완성된 파일은 오디오와 몇 백분의 1초 차이 안에서 맞았습니다. 4.55초 오디오는 4.58초 클립으로, 4.8초는 4.83초로, 5.21초는 5.25초로 나왔습니다. 보내기 전에 원하는 길이로 녹음을 잘라 주십시오.
두 가지 해상도, 인물 사진의 비율
480p 또는 768p를 고르십시오. Pruna는 출력이 인물 사진의 화면비를 따른다고 문서에 밝히고 있으며, 저희의 16:9 사진은 832x480과 1344x768로 나왔습니다.
빠른 처리
저희의 5초 테스트 클립은 두 해상도 모두에서 제출부터 완성 파일까지 27~39초가 걸렸습니다.
콘텐츠 필터 없음
SpicyAPI는 인물 사진, 프롬프트, 결과물 어디에도 필터를 걸지 않습니다. 저희 테스트에서 NSFW 연출은 480p에서 쓴 그대로 그려졌습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 아니요 | 선택 사항입니다. 제스처, 표정, 시선, 카메라 움직임을 적으십시오. |
image_url | 예 | 말하게 될 인물 사진입니다. JPEG, PNG 또는 WebP. |
audio_url | 예 | 말하기 또는 노래. MP3 또는 WAV, 1~180초. |
resolution | 아니요 | 480p 또는 768p(기본값 768p). 768p는 초당 요금이 더 비쌉니다. |
enable_prompt_expansion | 아니요 | 기본값은 꺼짐이므로 입력하신 지시를 그대로 씁니다. 켜면 먼저 더 풍부한 문장으로 다시 씁니다. 기본값: |
seed | 아니요 | 같은 인물 사진과 오디오로 두 실행을 비교하려면 무작위 시작 상태를 고정합니다. 프레임이 완전히 같은 결과를 보장하지는 않습니다. |
요금
입력 오디오의 1초당 요금이 청구되며, 1초 단위로 올림합니다. 길이는 1~180초이고, 768p는 480p보다 초당 요금이 비쌉니다. 결제 보류 금액은 오디오 길이를 따르며(읽을 수 없으면 최대 180초), 차액은 전달 시 풀립니다. 프롬프트 확장과 seed는 요금을 바꾸지 않습니다. 실패한 요청에는 요금이 청구되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.02 / 초 |
| $0.04 / 초 |
활용 사례
발표자와 설명 클립
스크립트를 한 번 녹음해 얼굴 사진과 짝지으면, 카메라를 보며 그것을 읽어 주는 진행자를 얻을 수 있습니다. 강의 도입부, 제품 소개, 공지에 활용하십시오.
캐릭터 목소리
캐릭터 사진에 성우나 음성 합성 모델이 녹음한 대사를 붙이고, 짧은 클립 시리즈 전체에서 같은 얼굴을 유지하십시오.
현지화 버전
같은 인물 사진에 발행하려는 언어마다 녹음을 달리 넣으면, 각 클립이 자신의 트랙에 맞춰 립싱크됩니다.
프롬프트 가이드 및 실전 팁
외모가 아니라 전달을 지시하십시오
인물 사진이 이미 얼굴, 의상, 공간을 정해 줍니다. 프롬프트는 작은 동작에 쓰십시오. 마이크 쪽으로 살짝 기울기, 핵심 문장에서 눈썹 올리기, 옷깃 쪽으로 천천히 움직이는 손, 천천히 다가가는 카메라 같은 것들입니다.
프롬프트가 장면을 바꿀 수 있습니다
인물 사진과 다른 장소나 의상을 묘사하는 프롬프트는 사진의 설정을 덮어쓸 수 있습니다. 저희 실행 중 하나에서는 텍스트에 맞춰 배경이 바뀌었습니다. 인물 사진을 그대로 두고 싶다면 프롬프트에서 배경을 빼십시오.
프롬프트 확장은 기본적으로 꺼져 있습니다
enable_prompt_expansion을 켜면 서비스가 생성 전에 지시를 더 풍부한 문장으로 다시 씁니다. 요금은 바뀌지 않지만, 결과가 입력하신 문장에서 벗어날 수 있습니다.
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/talking-avatar",
"input": {
"audio_url": "https://example.com/reference.mp3",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 레퍼런스에서 확인하세요.




