Vidu Q3 Spicy API

Vidu Q3 Spicy 영상 연장은 이미 가지고 있는 클립의 뒷이야기를 만듭니다. 클립을 video_url로 보내고, 원하면 다음에 일어날 일을 프롬프트로 적어 주세요. 클립의 마지막 프레임이 1~16초짜리 새 Vidu Q3 Spicy 이미지 투 비디오 샷의 시작 프레임이 되고, 둘은 하나의 MP4로 이어집니다. 원본이 먼저, 연장분이 그다음이며 이음매에서 겹치는 프레임은 제거됩니다. 새 구간은 별도 파일로도 돌아오므로 계속 연장하거나 따로 편집할 수 있습니다.

연속성은 마지막 프레임에서 나옵니다. 의상, 배경, 빛, 인물의 위치가 이어지는 것은 새 구간이 말 그대로 여러분의 마지막 프레임에서 시작하기 때문입니다. 움직임은 같은 방식으로 이어지지 않습니다. 모델이 보는 것은 클립 전체가 아니라 정지 이미지 한 장이므로, 속도나 방향이 그대로 유지될 거라 기대하지 말고 이어 가고 싶은 움직임을 적어 주세요.

하나의 파일과 새 부분 단독 파일이 함께 돌아옵니다. 이어 붙인 MP4는 원본 클립의 프레임 레이트와 화면 구성을 유지하며 검은 띠는 생기지 않습니다. 이음새를 맞추기 위해 화면 가장자리가 몇 퍼센트 정도 잘리거나 조정될 수 있습니다. 모델이 돌려준 영상의 화면 비율이 눈에 띄게 다르면 새 구간을 화면에 꽉 차게 확대해 가운데에 맞추고, 넘치는 부분은 잘라 냅니다. 파일은 H.264 MP4와 AAC 소리로 인코딩됩니다. 원본의 소리는 유지되고 새 구간에서 생성된 소리가 그 뒤를 잇습니다. 한쪽이 무음이면 무음으로 채워 이음매에서 화면과 소리가 어긋나지 않습니다. 출력의 두 번째 에셋은 새 구간만 담겨 있어 다음 연장이나 편집에 바로 쓸 수 있습니다.

나머지는 모두 Vidu Q3 Spicy 이미지 투 비디오와 같습니다. 새 구간은 이미지 투 비디오 엔드포인트와 같은 경로, 같은 콘텐츠 허용 범위, 같은 초당 가격으로 생성되며 생성이 실패하면 같은 방식으로 환불됩니다. 생성은 성공했지만 이어 붙이기만 만들지 못한 경우에도 작업은 실패로 처리되고 요금은 환불됩니다.

너무 일찍 끝난 샷을 늘릴 수 있습니다. 라벨이 카메라를 향하기 전에 멈춘 제품 턴테이블이나, 인물이 문에 닿기 전에 끊긴 걸음 장면이 그렇습니다. 몇 초만 연장하고 남은 움직임만 적으세요.

긴 시퀀스를 한 단계씩 쌓을 수 있습니다. 첫 샷을 만들어 연장하고, 이어 붙인 결과가 60초 원본 한도 안에 있는 동안 다시 연장하면 됩니다. 각 단계에서는 추가된 초만 과금됩니다. 모든 단계가 프레임 한 장에서 시작하므로 다음 단계를 쌓기 전에 이음매를 확인하세요.

# 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": "vidu/q3-spicy/video-extend",
  "input": {
    "duration_seconds": 5,
    "movement_amplitude": "auto",
    "resolution": "720p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

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