Skip to main content
POST
모델명 호환 안내: 이 엔드포인트는 호환 별칭을 지원합니다. veo3.1-fast-extveo3.1-fast, veo3.1-quality-extveo3.1-quality, veo3.1-lite-extveo3.1-lite와 각각 동일하므로 서로 바꿔 사용할 수 있고 효과도 동일합니다.

인증

string
필수
모든 API 엔드포인트에서 Bearer Token 인증이 필요합니다API Key 획득:API Key 관리 페이지에 접속하여 API Key를 획득하세요사용 시 요청 헤더에 추가:

요청 파라미터

string
기본값:"veo3.1-fast"
필수
비디오 생성 모델명사용 가능한 모델:
  • veo3.1-fast - 빠른 생성 모델, 빠른 미리보기 및 반복 작업에 적합 (호환 별칭 veo3.1-fast-ext)
  • veo3.1-quality - 고품질 생성 모델, 최종 제작에 적합 (호환 별칭 veo3.1-quality-ext)
  • veo3.1-lite - 경량 생성 모델, 저비용 대량 생성에 적합 (호환 별칭 veo3.1-lite-ext)
Example: "veo3.1-fast"
구버전 호출과의 호환을 위해 별칭 veo3.1-fast-ext(veo3.1-fast에 해당), veo3.1-quality-ext(veo3.1-quality에 해당), veo3.1-lite-ext(veo3.1-lite에 해당)는 계속 정상적으로 사용할 수 있습니다.
boolean
기본값:"false"
비디오 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
비디오 생성 텍스트 설명
integer
비디오 길이(초)고정값:8(VEO3은 8초 길이만 지원)
string
비디오 해상도지원 형식:
  • 16:9 (가로)
  • 9:16 (세로)
string
비디오 생성 유형지원 유형:
  • frame - 프레임-투-비디오 (FL 모드)
  • reference - 참조 이미지-투-비디오
미지정 시 이미지 수에 따라 자동 판단: 2장은 프레임-투-비디오, 3장은 참조 이미지-투-비디오주의: veo3.1-quality 모델은 reference 모드를 지원하지 않습니다
veo3.1-lite 모델은 이 파라미터를 지원하지 않습니다, 전달하지 마세요
array<url>
비디오 생성에 사용할 참조 이미지 URL 배열공개 접근 가능한 이미지 URL (http:// 또는 https://) 지원예시: ["https://example.com/image.jpg"]제한사항:
  • 최대 3장
  • 프레임-투-비디오 모드의 경우: 첫 번째 이미지가 시작 프레임, 두 번째 이미지가 종료 프레임
  • 최대 파일 크기:10MB
  • 지원 형식:.jpeg、.jpg、.png、.webp
veo3.1-lite 모델은 이 파라미터를 지원하지 않습니다, 전달하지 마세요
string
비디오 해상도지원되는 값:
  • 720p (기본값)
  • 1080p
  • 4k
boolean
GIF 출력 형식을 활성화합니다. 기본값: false주의: GIF와 1080p, 4k 해상도는 동시에 사용할 수 없습니다
boolean
기본값:"false"
공식 채널을 폴백으로 사용할지 여부
  • false: 사용하지 않음 (기본값)
  • true: 공식 채널 사용
veo3.1-lite 모델은 이 파라미터를 지원하지 않습니다, 전달하지 마세요

응답

integer
응답 상태 코드
array
응답 데이터 배열