아래 텍스트로 비디오 만들기 예제의 출력: gemini-omni-1.2-flash, 720p, 10초, 16:9. 인물이 프롬프트에 적은 대사를 말합니다
요금과 모델 선택
요금
Gemini Omni 1.2 Flash는 비디오 한 편 단위로 과금하며, 가격은resolution만으로 정해집니다.
seconds: 3~10초 모두 같은 가격입니다. 10초 720p 클립은 초당 $0.03꼴입니다.- 이미지: 첫 프레임이나 참조 이미지를 보내도 가격은 같습니다.
reasoning_effort와 종횡비: 어떤 값을 골라도 가격은 같습니다.
- 작업을 만들 때 과금되며, 실패한 작업은 전액 환불됩니다. 콘텐츠 심사에서 차단된 작업도 환불됩니다.
- 파라미터 오류로 제출 단계에서 거부된 요청은 과금되지 않습니다.
- 다시 제출하면 새 작업이 만들어져 다시 과금되므로, 자체 작업 ID와 작업
id의 대응 관계를 보관하세요.
비디오 모델 고르기
2026년 11월 11일 기준으로, 10초 1080p 클립에서 LaoZhang API의 비디오 모델 중 Gemini Omni 1.2 Flash가 가장 저렴합니다($0.45). 360p는 비디오당 $0.10이라 결과를 여러 번 시험해 볼 때 알맞습니다.- 인물이 대사를 말해야 하거나 1080p가 필요할 때: Gemini Omni 1.2 Flash를 쓰세요.
- 20~60초의 연속된 클립, 기존 비디오 이어 만들기, 1:1이나 4:3 같은 비율이 필요할 때: Muse를 쓰세요. 엔드포인트가 같은
/v1/videos라서 같은 토큰으로 모델만 바꾸면 됩니다. - 2K, 참조 비디오, 참조 오디오가 필요할 때: MiniMax H3를 쓰세요.
샘플 출력
아래 클립은 편집하지 않은 Gemini Omni 1.2 Flash 출력이며 모델이 만든 사운드트랙이 들어 있습니다. 클립을 눌러 재생하세요. 각 캡션에는 해상도, 길이, 종횡비, 프롬프트가 있습니다. Muse 샘플 출력과 MiniMax H3 샘플 출력은 같은 프롬프트를 쓰므로 장면별로 모델을 비교할 수 있습니다.720p, 5초, 16:9. 프롬프트: A red fox walking through snowy forest at sunrise, cinematic
720p, 10초, 16:9. 프롬프트: A paper boat drifts down a rainy city gutter, then sails into a small sunny pond
1080p, 10초, 16:9. 프롬프트: A hot air balloon rises over a valley at dawn, drifts over a river and a village, then lands in a meadow
1080p, 10초, 9:16 세로. 프롬프트: A cyclist rides through a coastal town from morning to sunset: market, harbor, cliff road, lighthouse
시작하기 전에
API 키 만들기
토큰 관리에서 다음 설정으로 API 키(콘솔에서는 ‘토큰’이라고 부릅니다)를 추가하세요.작동 방식
작업 생성
model과 prompt를 넣어 POST /v1/videos를 호출합니다. 이 엔드포인트는 비동기라서 비디오가 완성되기를 기다리지 않고 몇 초 안에 작업 id를 반환합니다. 이 값을 저장하세요.상태 조회
GET /v1/videos/{id}를 호출해 status를 읽습니다. 360p의 짧은 클립은 보통 30결과 다운로드
status가 completed가 되면 video_url에서 MP4를 내려받습니다. 다운로드에는 Authorization 헤더가 필요 없습니다.환경 설정
cURL 예제는 응답에서 필드를 읽기 위해jq를 사용합니다(macOS에서는 brew install jq). 먼저 키와 base URL을 설정하세요.
비디오 만들기
텍스트로 비디오 만들기
아래 요청의 프롬프트는 위 샘플 비디오를 만든 영어 프롬프트 그대로입니다.resolution: 생략하면720p입니다. 결과만 먼저 확인하려면360p를 보내세요. 비디오당 $0.10입니다.seconds: 3~10의 정수이며 생략하면 10입니다.aspect_ratio:16:9또는9:16이며 생략하면16:9입니다.
인물이 대사를 말하게 하기
대사를prompt에 그대로 적으세요. 따옴표로 묶고 누가 말하는지 밝히면 클립 속 인물이 그 대사를 말합니다. 대사는 한국어, 영어, 중국어, 일본어, 러시아어로 쓸 수 있습니다. 위 예제는 영어 대사를, 아래 첫 프레임 이미지 예제는 한국어 대사를 이렇게 적은 프롬프트입니다.
대사를 적지 않으면 모델이 장면에 맞는 환경음과 효과음을 넣습니다. 원하는 소리가 있다면 Soft rain and violin in the background처럼 프롬프트에 적으세요.
첫 프레임 이미지로 비디오 만들기
image로 이미지 한 장을 보내면 클립이 그 장면에서 시작합니다. 이미지는 공개 https URL 또는 data:image/...;base64, 데이터 URL이어야 합니다.
input_reference입니다.
-F로 업로드할 때는 Content-Type: application/json을 설정하지 마세요. 이미지는 한 장당 최대 10MB이며 JPEG, PNG, WebP를 지원합니다.
참조 이미지로 만들기
reference_images에 이미지를 여러 장 보내면 모델이 이미지 속 인물, 사물, 장면을 한 클립에 담습니다. 프롬프트에서는 배열 순서대로 image 1, image 2처럼 가리킵니다.
image와reference_images는 합쳐서 최대 6장입니다. 7장째부터는 오류가 반환됩니다.- multipart로 올릴 때 참조 이미지의 필드 이름은
reference_images이며 여러 번 반복해 보낼 수 있습니다. - 두 필드는 함께 보낼 수 있습니다.
image가 시작 장면을 정하고, 참조 이미지는 등장할 인물이나 사물을 제공합니다. - 실제 인물과 관련된 제한은 아래 콘텐츠 제한 절에 있습니다.
세로 비디오와 1080p 만들기
세로 비디오는"aspect_ratio": "9:16"을 보냅니다. size로 해상도와 비율을 한 번에 지정할 수도 있습니다. 아래는 1080p 세로 비디오 요청입니다.
size에 쓸 수 있는 값은 아래 요청 필드 절에 있습니다. 가격은 해당하는 해상도로 계산하므로 1080x1920은 1080p 가격인 $0.45입니다.
조회와 다운로드
작업 조회
status는 in_progress이고 progress에 대략적인 진행률이 표시됩니다.
video_url이 포함됩니다.
status: "failed"이고 사유가 error.message에 있습니다. 청구 금액은 이미 환불되었습니다.
비디오 다운로드
Authorization 헤더와 함께 GET /v1/videos/{id}/content를 호출해도 MP4 파일이 반환됩니다. 비디오 링크는 7일간 유지되므로 오래 쓸 파일은 내려받아 직접 보관하세요.
최소 Python 클라이언트
requests가 필요합니다(pip install requests).
API 레퍼런스
요청 필드
size 값이 가리키는 해상도와 비율입니다.
- 참조 비디오, 참조 오디오, 마지막 프레임(
video_url,last_frame등의 필드) - 2K와 4K, 그리고
16:9와9:16이외의 종횡비 - 3초보다 짧거나 10초보다 긴
seconds
출력 사양
- 형식은 MP4이며 H.264 비디오와 AAC 오디오 트랙, 24fps입니다.
- 크기와 길이는 요청한 값과 같습니다. 예를 들어
720p에9:16이면 720×1280으로 출력됩니다. - 파일에는 Google의 C2PA 콘텐츠 자격 증명과 눈에 보이지 않는 SynthID 워터마크가 들어 있습니다. 화면에 보이는 워터마크는 없습니다.
작업 상태
콘텐츠 제한
다음 두 종류의 콘텐츠는 모델이 차단합니다. 차단된 작업은failed로 반환되고 전액 환불됩니다.
- 실제 인물: 프롬프트에 실제 인물의 이름이 들어 있으면 차단됩니다. 모델은 실제 인물의 모습도 만들지 않으므로 유명인 사진 같은 이미지는 차단될 수 있습니다.
- 성적인 콘텐츠와 저작권으로 보호되는 캐릭터: 두 가지 모두 차단됩니다.
오류
오류 메시지는 영어로 반환됩니다. 아래 표는 오류가 나타나는 위치별로 정리한 것입니다.자주 묻는 질문
Gemini Omni 1.2 Flash API는 비디오 한 편에 얼마인가요?
해상도에 따라 과금합니다. 360p는 비디오당 $0.10, 720p는 $0.30, 1080p는 $0.45이며 3~10초 모두 같은 가격입니다. 10초 클립은 Google 공식 가격의 약 43%이고, 비교표는 위 요금 절에 있습니다.Gemini Omni 1.2 Flash에 Google 계정이나 Gemini API 키가 필요한가요?
필요 없습니다. LaoZhang API의default 그룹 토큰으로 POST /v1/videos를 호출하면 됩니다. 과금 방식은 사용량 우선으로 설정하세요.
Gemini Omni 1.2 Flash는 최대 몇 초까지 만들 수 있나요? 4K도 되나요?
한 편은 3Gemini Omni 1.2 Flash 비디오에 워터마크가 있나요?
화면에 보이는 워터마크는 없습니다. 파일에는 AI로 만든 비디오임을 표시하는 Google의 C2PA 콘텐츠 자격 증명과 눈에 보이지 않는 SynthID 워터마크가 들어 있습니다.Gemini Omni 1.2 Flash 비디오 생성에는 얼마나 걸리나요?
360p의 짧은 클립은 보통 30Muse나 Sora 2 코드를 Gemini Omni 1.2 Flash로 바꾸려면?
엔드포인트가 같으므로 작업 생성과 조회 경로, 토큰은 그대로 둡니다. 바꿀 것은 세 가지입니다.model을gemini-omni-1.2-flash로 바꿉니다.seconds를 3~10 사이로 맞춥니다.- 360p나 1080p가 필요하면
resolution을 추가합니다. 생략하면 720p입니다.
관련 문서와 출처
- 비디오 생성 API 비교와 가격: 비디오 모델별 한 편 비용, 엔드포인트, 토큰 그룹 비교
- Muse 비디오 API: 같은 엔드포인트로 만드는 20~60초 클립과 비디오 이어 만들기
- 모델 및 가격
- Gemini Omni 1.2 Flash 출시 공지(영어)
- Google: Gemini Omni 1.2 Flash 발표(모델 기능, 2026년 11월 11일 확인)
- Google: Gemini API 가격(공식 초당 가격, 2026년 11월 11일 확인)