Skip to main content
POST

인증

string
필수
모든 엔드포인트는 Bearer Token 인증이 필요합니다.API Key 발급:API Key 관리 페이지에 접속하여 API Key를 발급받으세요.요청 헤더에 다음을 추가합니다:

요청 파라미터

string
필수
비디오 생성 모델명. pixverse-v6로 고정됩니다.
boolean
기본값:"false"
비디오 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
비디오 콘텐츠 설명. 최대 5000자. 모든 모드에서 필수입니다.
string
기본값:"540p"
비디오 해상도. 과금에 직접 영향을 줍니다.
  • 360p: SD
  • 540p: 표준 (기본값)
  • 720p: HD
  • 1080p: Full HD
지정되지 않은 해상도는 파라미터 오류를 반환합니다.
integer
기본값:"5"
비디오 길이(초). 범위는 1-15.
시작/종료 프레임 전환 모드는 5 또는 8초만 지원합니다.
string
기본값:"16:9"
비디오 화면 비율. 텍스트→비디오와 다중 참조 이미지 융합 모드에서만 적용됩니다.
  • 16:9: 가로 와이드 (기본값)
  • 4:3: 가로 4:3
  • 1:1: 정사각형
  • 3:4: 세로 3:4
  • 9:16: 세로 (모바일)
  • 2:3: 세로 2:3
  • 3:2: 가로 3:2
  • 21:9: 시네마 와이드
integer
기본값:"0"
랜덤 시드. 범위는 0-2147483647. 동일한 prompt와 seed로 유사한 결과를 재현할 수 있습니다.
string
네거티브 프롬프트. 원치 않는 콘텐츠를 제외하는 데 사용. 최대 2048자.
boolean
기본값:"false"
오디오 트랙 생성 여부.
  • true: 오디오 생성 (과금 단가가 상승)
  • false: 오디오 미생성 (기본값)
boolean
기본값:"false"
비디오 우측 하단에 워터마크 추가 여부.
  • true: 워터마크 추가
  • false: 워터마크 미추가 (기본값)
string
모션 모드.
  • normal: 표준 모드 (pixverse-v6은 이 값만 지원)
fast는 구버전 모델 전용입니다. 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여야 합니다.

생성 모드

어댑터는 요청 필드에 따라 자동으로 해당 생성 모드로 분배합니다. 우선순위 순서로 매칭하며, 가장 먼저 조건을 만족하는 모드가 선택됩니다.
모든 이미지 입력은 공개적으로 접근 가능한 HTTP/HTTPS URL만 지원합니다. base64 또는 Data URI는 지원하지 않습니다. 로컬 이미지만 있는 경우, 먼저 오브젝트 스토리지에 업로드한 후 URL을 전달하세요.

파라미터 규칙

응답

integer
응답 상태 코드. 성공 시 200.
array
반환되는 작업 배열.

작업 결과 조회

비디오 생성은 비동기 작업입니다. 제출 후 task_id가 반환되며, 작업 상태 가져오기 엔드포인트로 진행 상황과 결과를 조회하세요.
cURL
상태가 completed 또는 failed로 변경될 때까지 5초 간격으로 폴링하는 것을 권장합니다.

성공 결과 예시

비디오 URL 경로는 data.result.videos[0].url[0]입니다. url 필드 자체도 배열입니다. 비디오 링크는 일반적으로 24시간 후 만료되므로 즉시 다운로드하거나 전송하세요.

실패 결과 예시

실패 시 cost는 일반적으로 0이며, 오류 원인은 data.error.message에서 확인하세요.

사용 시나리오

시나리오 1: 텍스트→비디오

시나리오 2: 이미지→비디오

시나리오 3: 시작/종료 프레임 전환

시나리오 4: 다중 참조 이미지 융합

시나리오 5: 비디오 연장