비디오

gemini-omni-1.1-flash

Google이 정식 제공하는 멀티모달 동영상 모델로, 생성과 자연어 편집, 프레임 보간, 동영상 연장을 지원합니다. APIMart는 전용 공식 채널에서 비동기 작업 추적과 해상도별 과금을 제공합니다.

멀티모달 동영상시작·종료 프레임360p~4K

API 키 발급 API 문서

서비스 하이라이트

99.9% SLA
공식 할인
종량제
고속 & 저지연

Input

모델

프롬프트

68 characters

화면 비율

해상도

Task

Prefer automatic inference unless the intended behavior is ambiguous.

First / Last Frame

첫 프레임

마지막 프레임

참조 이미지

참조 비디오

이전 작업 ID

Output

Video link valid for 72 hours

하나의 API로 멀티모달 동영상 생성 및 편집

텍스트 생성, 참조 이미지 애니메이션, 시작·종료 프레임 보간, 기존 영상 편집을 지원합니다. 360p, 720p, 1080p 또는 4K를 선택하고 APIMart 비동기 작업 흐름으로 모든 작업을 관리하세요.

API 키 받기

50K+

활성 사용자

99.9%

가동률

더 빠름

70%

비용 절감

Gemini Omni 1.1 Flash API 주요 기능

생성, 보간, 편집 및 연장 워크플로에 사용할 수 있는 공식 지원 사양

4단계 해상도

360p, 720p, 1080p, 4K 중에서 선택할 수 있습니다. 기본값은 720p이며 1080p와 4K는 업샘플링 출력입니다. API는 2160p도 4K의 별칭으로 허용합니다.

시작·종료 프레임 보간

first_frame_image만 사용해 시작 이미지를 움직이거나 last_frame_image를 함께 지정해 최종 장면을 제어할 수 있습니다. 종료 프레임만 제출할 수 없으며 두 이미지의 비율이 일치해야 합니다.

유연한 참조 이미지 입력

피사체 참조에는 image_urls를, first_frame과 last_frame 역할을 명시하려면 image_with_roles를 사용합니다. 참조 이미지와 프레임 이미지를 합해 최대 10개까지 가능합니다.

동영상 편집 및 연장

10초 이하 원본 동영상 1개를 간단한 지시로 편집하거나 extend_from_task_id로 성공한 APIMart 작업을 이어갈 수 있습니다. 대화형 연장을 반복하면 총 길이를 약 40초까지 늘릴 수 있습니다.

생성 오디오가 포함된 동영상

프롬프트에서 요청한 대화, 음악 또는 효과음이 포함된 24fps 영상을 생성합니다. 오디오 파일은 입력할 수 없으므로 사운드 지시는 텍스트에 작성해야 합니다.

비동기 REST 워크플로

POST /v1/videos/generations로 작업을 제출하고 반환된 task_id를 저장합니다. GET /v1/tasks/{task_id}를 조회하다가 status가 completed 또는 failed가 되면 중지합니다.

작업 유형 자동 판별

입력에 따라 작업을 자동으로 판별하거나 metadata.task에 text_to_video, image_to_video, reference_to_video, edit 또는 extend를 지정할 수 있습니다.

해상도 기반 사용량 과금

해상도에 따라 출력 토큰 요금 구간이 결정됩니다. APIMart는 최대 10초 출력 비용을 먼저 확보한 뒤 실제 사용량으로 정산하며, 실패한 작업에는 요금이 부과되지 않습니다.

실무 멀티모달 동영상 워크플로

공식 지원 입력 방식을 활용한 세밀한 제작 및 자동화 작업

시작에서 종료 프레임으로 전환

제품 공개, 장면 전환, 전후 비교처럼 시작 이미지와 도착할 마지막 이미지를 명확히 지정해야 하는 영상을 만들 수 있습니다.

참조 이미지 기반 제품 애니메이션

제품과 인물 이미지를 참조로 제공하고 하나의 요청에서 각 피사체가 어떻게 움직이고 상호작용할지 설명할 수 있습니다.

기존 영상의 선택적 수정

짧은 영상을 업로드하고 자연어로 특정 변경 사항을 요청하세요. 하나의 변경과 유지할 요소를 간단히 설명하면 편집 결과를 더 명확하게 제어할 수 있습니다.

캠페인 스토리보드

360p 또는 720p에서 카메라, 속도, 분위기, 조명과 오디오를 먼저 검토한 뒤 고해상도 최종 렌더링으로 전환해 시간과 크레딧을 절약할 수 있습니다.

가로형 및 세로형 콘텐츠

프레젠테이션과 웹 영상에는 16:9를, 모바일 중심 캠페인에는 9:16을 선택하세요. 지원하지 않는 화면 비율은 기본값인 16:9로 처리됩니다.

동영상 파이프라인 자동화

제출, 상태 조회, 비용 정산, 결과 가져오기를 사내 도구에 통합하여 공급자마다 별도의 작업 시스템을 유지할 필요를 줄일 수 있습니다.

API로 동영상 생성 시작하기

키를 만들고 올바른 비동기 요청을 제출한 뒤 완성된 영상 가져오기

APIMart API 키 만들기

APIMart에 로그인해 API 키를 만들고 Authorization 헤더에 Bearer 토큰으로 전송합니다. 키는 서버에서 보관하고 공개 클라이언트 코드에 노출하지 마세요.

→

유효한 요청 구성하기

model을 gemini-omni-1.1-flash로 설정하고 prompt 또는 지원되는 이미지·동영상 소재를 하나 이상 제공합니다. 생략하면 resolution은 720p, aspect_ratio는 16:9가 됩니다.

→

제출, 조회 및 결과 저장

생성 요청을 제출하고 반환된 task_id를 완료될 때까지 조회합니다. result.videos[0].url에서 영상 URL을 가져오고 장기간 보관할 결과는 다운로드하세요.

첫 동영상 생성하기

Gemini Omni 1.1 Flash API 자주 묻는 질문

APIMart에서 지원하는 입력, 파라미터, 제한, 요금 및 작업 처리 방식

Gemini Omni 1.1 Flash API란 무엇인가요?

Google이 정식 제공하는 멀티모달 동영상 모델로 텍스트 동영상 생성, 이미지 동영상 변환, 시작·종료 프레임 보간, 동영상 편집, 대화형 연장을 지원합니다. APIMart에서는 전용 모델 ID gemini-omni-1.1-flash를 통합 동영상 API에 사용합니다.

어떤 요청 파라미터를 지원하나요?

model, prompt, resolution, aspect_ratio, image_urls, first_frame_image, last_frame_image, image_with_roles, video_urls, metadata.task, extend_from_task_id를 지원합니다. prompt 또는 하나 이상의 이미지·동영상 소재가 필요합니다.

동영상 길이를 지정할 수 있나요?

아니요. 생성 영상은 약 3~10초이지만 이 API는 duration 파라미터를 제공하지 않습니다. 출력은 24fps이며 생성된 오디오를 포함합니다.

시작·종료 프레임은 어떻게 사용하나요?

이미지 동영상 변환에는 first_frame_image만 사용하고, 보간에는 first_frame_image와 last_frame_image를 함께 제출합니다. last_frame_image만 보내면 400 invalid_frame_images 오류가 발생합니다. 두 이미지의 비율을 동일하게 하고 aspect_ratio와 맞추세요.

이미지, 동영상, 오디오는 얼마나 입력할 수 있나요?

시작·종료 프레임을 포함해 이미지는 총 10개까지, 참조 또는 편집용 동영상은 10초 이하 1개까지 입력할 수 있습니다. 공개 HTTP(S) URL과 지원되는 base64 데이터 URL을 사용할 수 있습니다. 오디오 입력과 YouTube 링크는 지원하지 않습니다.

생성 작업을 어떻게 제출하고 확인하나요?

POST /v1/videos/generations로 요청하고 task_id를 저장한 다음 GET /v1/tasks/{task_id}를 5~10초 간격으로 조회합니다. 4K 및 동영상 입력 작업은 더 오래 걸리므로 클라이언트 제한 시간을 최대 10분으로 설정하세요.

동영상 편집과 대화형 연장은 어떻게 다른가요?

직접 편집할 때는 video_urls에 동영상 1개와 간단한 프롬프트를 전달합니다. 이전 결과를 다시 업로드하지 않고 이어가려면 extend_from_task_id에 성공한 APIMart 작업 ID를 지정합니다. 해당 작업은 현재 사용자가 소유한 Omni 모델 결과여야 합니다.

해상도 기반 요금은 어떻게 계산되나요?

선택한 해상도에 따라 출력 토큰 단가가 결정됩니다. APIMart는 최대 10초 분량의 크레딧을 먼저 확보하고 성공 후 실제 토큰 사용량으로 조정합니다. 실패한 작업은 과금되지 않으며 잔액이 부족하면 HTTP 402가 반환됩니다.

지원하지 않는 생성 파라미터는 무엇인가요?

system prompt, temperature, negative prompt 전용 필드, 오디오 입력, duration 파라미터를 지원하지 않습니다. 제외 조건과 사운드 지시는 prompt에 직접 작성하세요.

도움이 필요할 때 어떻게 문의하나요?

페이지 오른쪽 하단의 실시간 채팅, [email protected] 이메일, 또는 Discord 커뮤니티를 통해 문의하실 수 있습니다. 최대한 빠르게 답변드리겠습니다.