Skip to main content
POST

인증

string
필수
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지에서 API 키를 받으세요요청 헤더에 추가:

요청 매개변수

string
필수
비디오 생성 모델 이름지원 모델:
  • viduq3-mix - 종합 화질왕, 스마트 전환 더 강력, 1초 짧은 비디오 지원
  • viduq3 - 기본 추천, 카메라 전환이 더 스마트
선택 방법: 일상적인 사용에는 viduq3, 고화질이나 1-2초 모션 이펙트에는 viduq3-mix를 사용하세요.
boolean
기본값:"false"
비디오 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
텍스트 프롬프트, 최대 5000자동작과 카메라 움직임을 설명하고, 외모는 설명하지 마세요 (외모는 참조 이미지에서 결정됩니다).예시: "호숫가에서 산타클로스와 곰이 포옹하고 있다"
array<url>
필수
참조 이미지 URL 배열, 1-7장공개 접근 가능한 이미지 URL (http:// 또는 https://) 지원예시: ["https://example.com/santa.png", "https://example.com/bear.png"]
  • 수량: 1-7장
  • 지원 형식: PNG, JPEG, JPG, WebP
  • 최소 크기: 128×128
  • 화면 비율: 1:4 ~ 4:1 범위
  • 개당 크기: ≤ 50MB
  • 공개 접근 가능한 URL이어야 합니다
integer
기본값:"5"
비디오 길이 (초)
  • viduq3-mix: 1에서 16
  • viduq3: 3에서 16
기본값: 5
viduq3는 최소 3초, viduq3-mix는 최소 1초를 지원합니다. 선택한 모델에 따라 유효한 길이를 전달해주세요.
string
기본값:"720p"
비디오 해상도
  • viduq3-mix: 720p (기본값) / 1080p
  • viduq3: 540p / 720p (기본값) / 1080p
viduq3-mix540p를 지원하지 않습니다. 720p 또는 1080p를 사용해주세요.
string
기본값:"16:9"
비디오 화면 비율옵션:
  • 16:9 - 가로 (기본값)
  • 9:16 - 세로
  • 4:3 - 전통형
  • 3:4 - 세로 전통형
  • 1:1 - 정사각형
integer
생성 랜덤성을 제어하는 랜덤 시드미지정 시 랜덤으로 생성됩니다.
동일한 매개변수에서 동일한 seed 값을 사용하면 유사한 결과가 생성되지만, 완전히 동일하다는 보장은 없습니다.

모델 비교

응답

integer
응답 상태 코드, 성공 시 200
array
응답 데이터 배열

사용 시나리오

시나리오 1: viduq3 기본 참조 이미지-투-비디오

시나리오 2: viduq3-mix 고화질 참조 이미지-투-비디오

작업 결과 조회비디오 생성은 비동기 작업으로, 제출 시 task_id가 반환됩니다. 작업 상태 가져오기 엔드포인트를 사용하여 생성 진행 상황과 결과를 조회할 수 있습니다.