Skip to main content
POST

인증

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

요청 파라미터

string
필수
비디오 생성 모델 이름입니다. Omni-Flash-Ext로 고정됩니다.
string
필수
비디오 내용 설명입니다. 장면, 인물, 동작, 환경, 카메라 움직임, 화면 스타일, 오디오 힌트를 자세히 작성하는 것을 권장합니다.예: "a girl is dancing happily in a sunny garden"
integer
기본값:"6"
비디오 길이입니다. 단위는 초입니다.지원 값: 4, 6, 8, 10.
5, 7 등 다른 값을 전달하면 invalid_duration 오류가 반환됩니다.
참조 비디오를 업로드할 때는 duration을 전달할 필요가 없습니다. durationvideo_urls는 동시에 전달할 수 없습니다.
string
기본값:"720p"
비디오 해상도입니다. 대소문자를 구분하지 않습니다.지원 값:
  • 720p
  • 1080p
  • 4k
다른 해상도를 전달하면 invalid_resolution 오류가 반환됩니다.
string
기본값:"16:9"
비디오 화면 비율입니다. 가로 또는 세로 출력을 제어합니다.자주 사용하는 값:
  • 16:9 - 가로
  • 9:16 - 세로
기본값: 16:9
string
호환 필드입니다. aspect_ratio와 같은 의미입니다. 둘 다 전달하는 경우 같은 값으로 유지하는 것을 권장합니다.
string
생성 유형으로, 이미지의 사용 방식을 지정합니다.가능한 값:
  • frame - 시작 프레임 모드. image_urls에는 이미지 1장만 업로드할 수 있으며, 비디오의 시작 프레임으로 사용됩니다.
  • reference - 참조 모드. image_urls에는 이미지 1장 또는 3장을 업로드할 수 있으며, 참조 이미지로 사용됩니다.
generation_typeframe인 경우 image_urls는 1장만 지원하며, 다른 개수를 전달하면 unsupported_image_count 오류가 반환됩니다.
array<url>
참조 이미지 URL 배열입니다. generation_type에 따라 생략하거나, 1장 또는 3장을 전달할 수 있습니다:
  • 생략 또는 빈 배열: 텍스트-비디오
  • 1장: 단일 이미지-비디오
  • 3장: 참조 이미지 융합(generation_typereference일 때만 지원)
generation_type과의 관계:
  • generation_typeframe: 이미지 1장만 업로드할 수 있습니다.
  • generation_typereference: 이미지 1장 또는 3장을 업로드할 수 있습니다.
공개적으로 접근 가능한 이미지 URL만 지원합니다.
2장 이미지로 시작 프레임 + 끝 프레임을 지정하는 모드는 지원하지 않습니다. 2장을 전달하면 unsupported_image_count 오류가 반환됩니다. 4장 이상은 충분히 검증되지 않았으므로 권장하지 않습니다.
array<url>
참조 비디오 URL 배열입니다. 생략하거나 참조 비디오 1개를 전달할 수 있습니다.공개적으로 접근 가능한 HTTP/HTTPS 비디오 URL만 지원합니다. image_urls와 함께 전달할 수 있으며, 이미지는 인물 또는 구도 참조로, 비디오는 움직임 참조로 사용됩니다.
Omni-Flash-Ext는 참조 비디오를 0개 또는 1개만 지원합니다. 2개 이상 전달하면 unsupported_video_count 오류가 반환됩니다.
video_urls를 전달할 때는 duration을 전달할 필요가 없습니다. video_urlsduration은 동시에 전달할 수 없습니다.

응답

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

작업 결과 조회

비디오 생성은 비동기 작업입니다. 제출 후 task_id가 반환됩니다. 작업 상태 조회 API로 진행 상황과 결과를 조회하세요.
cURL
제출 후 5-10초 기다린 뒤 처음 조회하고, 이후 5-10초마다 폴링하는 것을 권장합니다. 단일 작업은 일반적으로 약 3-5분 안에 완료됩니다.

성공 결과 예시

실패 결과 예시

사용 사례

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

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

시나리오 3: 3장 참조 이미지 융합

시나리오 4: 4K 짧은 비디오

시나리오 5: 참조 비디오 생성

오류 코드

작업이 실패하면 작업 상태 API가 data.error에 실패 사유를 반환합니다. 일반적인 원인은 업스트림 할당량 일시 부족, 콘텐츠 심사 실패, 업스트림 타임아웃입니다.