소개
PixVerse V6 이미지→영상은 첫 프레임을 360p, 540p, 720p 또는 1080p의 1~15초 클립으로 애니메이션합니다. last_image_url을 추가하면 클립이 첫 이미지에서 마지막 이미지로 움직입니다. 프롬프트는 필수이며 일어나는 일을 묘사합니다. 클립은 첫 이미지의 화면비를 따릅니다. 이미지는 JPG, JPEG, PNG 또는 WebP이며 장당 최대 20MB입니다. PixVerse가 생성 전에 프롬프트와 이미지를 검토하며, 거부된 요청은 실패하고 요금이 청구되지 않습니다.
시작 소재에 따라 PixVerse V6 모드 고르기
| 시작할 때 가진 것 | 모드 |
|---|---|
| 글로 쓴 장면 | PixVerse V6 텍스트→영상 |
| 첫 프레임, 그리고 선택적으로 마지막 프레임 | PixVerse V6 이미지→영상 (현재 보고 계신 곳) |
| 캐스팅할 사람, 사물, 장소의 사진 | PixVerse V6 레퍼런스→영상 |
| 이어 가고 싶은 클립 | PixVerse V6 영상 연장 |
| 프롬프트 또는 이미지 한 장, 그리고 더 높은 화질이 필요할 때 | PixVerse V6 Max |
| 사진 한 장과 미리 만들어진 테마 템플릿, 쓸 프롬프트는 없음 | PixVerse V6 Effects |
핵심 기능 및 하이라이트
첫 프레임, 선택적 마지막 프레임
image_url은 시작을, last_image_url은 끝을 설정합니다. 저희 테스트에서 흰색 천문대 돔의 열린 틈 앞에 선 적갈색 코트 차림 여성(첫 프레임)과, 난간에 기대 팔짱을 낀 같은 여성(마지막 프레임)이 하나의 움직임이 되었습니다. 그녀는 돌아서서 난간을 따라 걷고, 몸을 뒤로 기대고 팔짱을 끼며, 클립은 마지막 프레임에서 끝났습니다.
모양은 이미지를 따릅니다
화면비 필드는 없습니다. 세로 이미지는 세로 클립으로, 가로 이미지는 가로 클립으로 나옵니다.
멀티샷 스위치
shot_type의 기본값은 single입니다. multi로 설정하면 모델이 클립을 여러 샷으로 나눕니다. 마지막 프레임과는 함께 쓸 수 없습니다.
원할 때만 사운드
generate_audio는 기본적으로 꺼져 있습니다. 켜면 모델이 분위기음, 효과음, 음악, 따옴표로 쓴 대사를 생성합니다. 사운드를 켜면 초당 요금이 더 비쌉니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수, 3~5,000자. 프레임 사이와 프레임 이후에 일어나는 일을 묘사하십시오: 동작과 카메라. 3자 이상 · 5000자 이하 |
image_url | 예 | 필수. 첫 프레임. |
last_image_url | 아니요 | 선택 사항, 마지막 프레임. 형식과 크기는 같습니다. |
resolution | 아니요 | 360p, 540p, 720p(기본값) 또는 1080p. 해상도가 높을수록 초당 요금이 더 비쌉니다. |
duration_seconds | 아니요 | 1~15의 정수 초(기본값 5). 요금은 초 단위로 청구됩니다. |
generate_audio | 아니요 | 기본값은 꺼짐. 켜면 영상과 함께 사운드를 생성합니다: 분위기음, 효과음, 음악, 따옴표로 쓴 대사. 기본값: |
shot_type | 아니요 | single(기본값) 또는 multi. multi는 모델이 클립을 여러 샷으로 나누게 하며, 마지막 프레임과는 함께 쓸 수 없습니다. |
seed | 아니요 | 선택 사항, 0~2147483647의 정수. 한 번에 한 가지만 바꾸며 비교하는 데 유용합니다. |
요금
출력 초 단위로 요금이 청구됩니다. 해상도와 오디오 스위치는 초당 요금을 바꾸고, 샷 유형과 seed는 바꾸지 않습니다. 실패하거나 거부된 요청에는 요금이 청구되지 않습니다.
| 해상도 | 오디오 생성: 아니요 | 오디오 생성: 예 |
|---|---|---|
| $0.0222 / 초 | $0.0311 / 초 |
| $0.0311 / 초 | $0.04 / 초 |
| $0.04 / 초 | $0.0533 / 초 |
| $0.08 / 초 | $0.1022 / 초 |
활용 사례
정지 이미지에 생명 불어넣기
인물 사진, 거리 장면, 이전 클립에서 저장한 프레임 등. 다음에 일어날 일을 묘사하면 인물, 의상, 배경은 이미지에서 가져옵니다.
두 포즈 사이의 움직임
첫 프레임과 다른 마지막 프레임을 주고, 저희 천문대 예시처럼 모델이 움직임을 채우게 하십시오.
샷마다 인물 유지하기
한 클립에서 프레임을 저장해 다음 클립의 첫 프레임으로 쓰면, 샷에서 샷으로 인물과 세트를 이어 갈 수 있습니다.
프롬프트 가이드 및 실전 팁
그림이 아니라 움직임을 묘사하기
이미지는 이미 모든 것이 어떻게 보이는지 보여 줍니다. 프롬프트는 동작, 카메라 움직임, 그리고 사운드를 켰다면 사운드에 쓰십시오.
두 프레임을 일관되게 유지하기
첫 프레임과 마지막 프레임에 같은 인물과 세트를 쓰십시오. 서로 어긋나는 프레임은 모델이 둘 사이를 자연스럽게 잇는 움직임을 찾기 어렵게 만듭니다.
각 동작에 여유 주기
저희 주유소 테스트에서는 프롬프트에 램프, 지도, 걷기, 지나가는 트럭을 나열했습니다. 남자는 지도를 접어 넣고 차까지 걸어갔고, 헤드라이트를 켠 트럭은 5초 클립의 마지막 1초에 나타났습니다. 늦게 나오는 동작이 중요하다면 동작 수를 줄이거나 초를 늘리십시오.
seed로 비교하기
seed는 한 번에 한 가지만 바꾸면서 실행 결과를 비교할 수 있게 해 줍니다. 프레임이 완전히 같은 결과를 보장하지는 않습니다.
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": "pixverse/v6/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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 레퍼런스에서 확인하세요.
