PixVerse V6 API

PixVerse V6 레퍼런스→영상은 보내 주신 사진으로 클립을 만듭니다. 한 요청에 요소를 최대 7개까지 담을 수 있습니다. PixVerse는 이 모드를 Fusion이라고 부릅니다. 각 요소에는 이름, 사진 한 장, 역할이 있습니다. 역할은 사람, 동물, 사물, 제품을 위한 subject, 또는 장소와 배경을 위한 background입니다. 각 요소가 나타날 자리에 프롬프트에 @name을 쓰십시오. 클립은 360p1080p에서 115초이며, 화면비는 8가지입니다. PixVerse가 생성 전에 프롬프트와 이미지를 검토하며, 거부된 요청은 실패하고 요금이 청구되지 않습니다.

시작 소재에 따라 PixVerse V6 모드 고르기

요소에 이름 붙이기

각 요소에 1~30자의 이름을 붙이고 프롬프트에서 @name으로 부르십시오. 저희 테스트에서는 maya(머스터드색 재킷을 입은 머리가 붉은 여성 사진)와 trailer(크롬 여행용 트레일러 사진)가 황혼 샷이 되었습니다. 전구 줄이 켜진 트레일러 앞에서 그녀가 김이 나는 에나멜 머그를 들고 카메라 쪽으로 걸어왔습니다. 얼굴, 머리, 재킷이 레퍼런스와 맞았고, 트레일러도 맞았습니다.

이름 뒤에 공백 넣기

저희 테스트에서 "@trailer,"처럼 이름 바로 뒤에 쉼표가 붙으면 이름이 일치하지 않아 거부되었고, "@trailer and"는 작동했습니다. 실패한 요청에는 요금이 청구되지 않습니다. @name 뒤에는 공백을 넣어 쓰십시오.

주체와 배경

사람, 동물, 사물, 제품에는 role을 subject(기본값)로, 장소에는 background로 설정하십시오. 한 요청에 이 둘을 합쳐 최대 7개까지 섞을 수 있습니다.

작은 아티팩트는 생길 수 있습니다

저희 샘플에서는 한 프레임에서 문간에 두 번째 인물이 잠깐 보였습니다. 공개하기 전에 클립을 확인하십시오.

사진으로 찍은 적 없는 장소에 사람 넣기

요소 하나는 인물 사진, 배경은 장소 사진으로 두고, 프롬프트에 동작을 쓰십시오.

차량이나 제품을 일관되게 유지하기

자동차, 트레일러, 제품에 각각 요소를 하나씩 주면 만드는 모든 클립에서 원본 사진과 맞습니다.

짧은 장면 캐스팅하기

요소를 두세 개 이름 붙이고, 그들이 어떻게 만나는지 쓴 뒤 카메라 움직임을 더하십시오.

# 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/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://example.com/reference.png"
      }
    ],
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "duration_seconds": 5
  }
}'

# 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 레퍼런스에서 확인하세요.