Skip to main content
POST

인증

string
필수
모든 요청은 Bearer Token 인증이 필요합니다.API Key 발급:API Key 관리 페이지에서 API Key를 발급받으세요.요청 시 다음 헤더를 추가합니다:

요청 파라미터

string
필수
비디오 생성 모델 이름입니다. gemini-omni-flash-preview로 고정됩니다.
string
필수
텍스트 지시문입니다. 텍스트-비디오에서는 장면 설명, 이미지 / 비디오-비디오에서는 동작 / 스타일 / 편집 지시입니다.
prompt와 참조 소재(image_urls / video_urls) 중 최소 하나는 제공해야 합니다.
array<string>
참조 이미지로, 최대 16장입니다. 각 항목은 http(s):// URL 형식입니다.JPEG / PNG를 지원합니다. 여러 주체(예: 「고양이 + 털실뭉치」)는 여러 장을 전달하고, prompt에서 이들이 어떻게 상호작용하는지 설명할 수 있습니다.
array<string>
참조 / 편집 대상 비디오로, 최대 1개입니다(다중 비디오 참조는 지원하지 않습니다). http(s):// 직접 링크 또는 data:video/... 형식일 수 있습니다.
  • 참조 비디오는 1~24초이며, 공식적으로 ≤3초를 권장합니다.
  • video_urlsextend_from_task_id상호 배타적이며, 둘 중 하나만 제공할 수 있고 동시에 전달할 수 없습니다.
string
기본값:"16:9"
비디오 화면 비율로, 실제 출력 화면의 방향을 제어합니다.
video_urls를 전달하면 aspect_ratio 매개변수가 적용되지 않습니다.
다음만 지원합니다:
  • 16:9 - 가로(기본값)
  • 9:16 - 세로
다른 값은 16:9로 처리됩니다.
string
기본값:"720p"
비디오 해상도입니다. 현재 720p만 지원합니다.
string
이전 작업 ID입니다. 이전 생성 작업의 ** task_id**를 입력합니다.
extend_from_task_idvideo_urls상호 배타적이며, 둘 중 하나만 제공할 수 있고 동시에 전달할 수 없습니다.

응답

integer
응답 상태 코드입니다. 성공 시 200입니다.
array
작업 배열을 반환합니다.

작업 결과 조회

비디오 생성은 비동기 작업입니다. 제출 후 task_id가 반환되며, 작업 상태 조회 API로 생성 진행 상황과 결과를 조회합니다.

성공 결과 예시

사용 사례

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

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

시나리오 3: 비디오-비디오