Pixverse v6
Pixverse v6 비디오 생성
- Pixverse v6 통합 비디오 생성 모델
- 텍스트→비디오, 이미지→비디오, 시작/종료 프레임 전환, 다중 참조 이미지 융합, 비디오 연장 지원
- 360p/540p/720p/1080p 해상도, 1-15초 비디오 길이 지원
- 비동기 작업 API. 제출 후 작업 ID로 결과를 조회합니다.
POST
인증
string
필수
요청 파라미터
string
필수
비디오 생성 모델명.
pixverse-v6로 고정됩니다.boolean
기본값:"false"
비디오 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
true:omni-moderation-latest로 프롬프트와 입력 이미지를 검토false또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
비디오 콘텐츠 설명. 최대 5000자. 모든 모드에서 필수입니다.
string
기본값:"540p"
비디오 해상도. 과금에 직접 영향을 줍니다.
360p: SD540p: 표준 (기본값)720p: HD1080p: Full HD
integer
기본값:"5"
비디오 길이(초). 범위는
1-15.string
기본값:"16:9"
비디오 화면 비율. 텍스트→비디오와 다중 참조 이미지 융합 모드에서만 적용됩니다.
16:9: 가로 와이드 (기본값)4:3: 가로 4:31:1: 정사각형3:4: 세로 3:49:16: 세로 (모바일)2:3: 세로 2:33:2: 가로 3:221:9: 시네마 와이드
integer
기본값:"0"
랜덤 시드. 범위는
0-2147483647. 동일한 prompt와 seed로 유사한 결과를 재현할 수 있습니다.string
네거티브 프롬프트. 원치 않는 콘텐츠를 제외하는 데 사용. 최대 2048자.
boolean
기본값:"false"
오디오 트랙 생성 여부.
true: 오디오 생성 (과금 단가가 상승)false: 오디오 미생성 (기본값)
boolean
기본값:"false"
비디오 우측 하단에 워터마크 추가 여부.
true: 워터마크 추가false: 워터마크 미추가 (기본값)
string
모션 모드.
normal: 표준 모드 (pixverse-v6은 이 값만 지원)
boolean
기본값:"false"
다중 클립 연속 비디오 생성 여부. 텍스트→비디오 및 이미지→비디오 모드에서만 지원합니다.
true: 다중 클립 연속 비디오 생성false: 단일 클립 (기본값)
array<url>
이미지→비디오의 입력 이미지 URL 배열. 첫 번째 이미지만 사용됩니다.이미지는 공개적으로 접근 가능한 HTTP/HTTPS URL이어야 합니다.
url
시작/종료 프레임 전환 모드의 시작 프레임 이미지 URL.
last_frame_image와 반드시 함께 전달해야 합니다.url
시작/종료 프레임 전환 모드의 종료 프레임 이미지 URL.
first_frame_image와 반드시 함께 전달해야 합니다.array<url>
다중 참조 이미지 융합 모드의 참조 이미지 URL 배열. 1-7장 지원.이 필드를 전달하면 다중 참조 이미지 융합 모드가 활성화됩니다.
string
비디오 연장 소스 작업 ID. 이 필드를 전달하면 비디오 연장 모드가 활성화됩니다.소스 작업은 현재 사용자의 것이어야 하며, 모델은
pixverse-v6, 상태는 completed여야 합니다.생성 모드
어댑터는 요청 필드에 따라 자동으로 해당 생성 모드로 분배합니다. 우선순위 순서로 매칭하며, 가장 먼저 조건을 만족하는 모드가 선택됩니다.파라미터 규칙
응답
integer
응답 상태 코드. 성공 시
200.array
반환되는 작업 배열.
작업 결과 조회
비디오 생성은 비동기 작업입니다. 제출 후task_id가 반환되며, 작업 상태 가져오기 엔드포인트로 진행 상황과 결과를 조회하세요.
cURL
completed 또는 failed로 변경될 때까지 5초 간격으로 폴링하는 것을 권장합니다.
성공 결과 예시
data.result.videos[0].url[0]입니다. url 필드 자체도 배열입니다. 비디오 링크는 일반적으로 24시간 후 만료되므로 즉시 다운로드하거나 전송하세요.
실패 결과 예시
cost는 일반적으로 0이며, 오류 원인은 data.error.message에서 확인하세요.