소개
video_url, 구체적인 편집 지시, 출력 해상도를 보냅니다. 길이나 화면비 설정 없이 기존 영상을 수정합니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 제공사 | |
| Gemini API 제공 시점 | Google 발표 기준 2026년 11월 5일부터 정식 제공 |
| 모델 코드 | gemini-omni-1.2-flash |
| 생성 길이 | 3–15초, 정수 단위 설정, 기본값 8초 |
| 마지막 프레임 사용 시 길이 | 마지막 이미지를 제공하면 3–10초 |
| 편집 길이 | 원본 길이에 따르며 10초 이후 구간은 잘라 냄 |
| 출력 해상도 | Google 안내 기준 360p·720p 직접 출력, 1080p·4K는 Google이 업스케일 |
| 생성 화면비 | 16:9 또는 9:16, 기본값 16:9 |
| 영상 및 오디오 형식 | AAC 오디오 트랙이 포함된 24 fps MP4 |
| 참조 입력 | 이미지 최대 6장, 영상 최대 3개이며 각 영상은 3초 이하 |
| 긴 참조 영상 생성 | Google 안내 기준 11–15초 출력에는 참조 영상 1개 사용 |
| 워터마크 | Google의 보이지 않는 SynthID 워터마크 포함 |
| 생성 영상 보관 | 14일 후 삭제 |
핵심 기능 및 하이라이트
현장 사운드가 어우러진 시장의 한순간
자체 테스트의 6초 720p 시장 장면에서는 요리사가 불길이 솟는 웍에서 면을 볶으며 요청한 대사를 말했습니다. 기름이 지글거리는 소리, 빗소리, 시장의 말소리도 동작과 함께 나왔습니다.
보트가 출발하는 순간을 움직임으로
5초 부두 예시는 야간 정지 이미지 한 장에서 시작합니다. 자체 테스트에서는 승객이 작별 인사를 하는 동안 목제 스피드보트가 호텔에서 천천히 멀어졌고, 엔진 소리와 물소리, 멀리서 들리는 밴드 음악이 함께 생성되었습니다.
동작이 끝날 자세까지 설계합니다
스튜디오의 첫 이미지와 마지막 자세를 바탕으로 만든 5초 애니메이션입니다. 자체 테스트에서는 카메라가 고정된 상태로 무용수가 두 자세 사이를 움직였고, 잔잔한 피아노 음악이 흘렀습니다.
두 인물을 기차 안 장면으로
자체 테스트에서 참조 인물 사진 두 장으로 6초 식당칸 장면을 만들었습니다. 한 여행자가 테이블 건너로 접은 쪽지를 건네자 상대가 읽고 미소 지었으며, 기차의 규칙적인 소리와 식기 소리가 어우러졌습니다.
공연 무대를 호숫가로 옮깁니다
자체 편집 테스트에서는 회색 스튜디오가 안개 낀 수면 옆 달빛 비추는 무대로 바뀌었습니다. 배경이 바뀌는 동안 무용수와 동작은 장면에 유지되었습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 시각적 변경을 설명하는 짧은 지시이며 필수입니다. Google은 간단히 적고 ‘Keep everything else the same.’으로 끝내도록 권장합니다. 1자 이상 · 20000자 이하 |
video_url | 예 | 필수 원본 클립 URL입니다. 출력은 원본 길이를 따르며 10초를 넘는 원본은 10초에서 자릅니다. 1자 이상 |
resolution | 아니요 | 360p, 720p(기본값), 1080p, 4K를 사용합니다. Google 안내 기준 360p·720p는 직접 출력이고, 1080p·4K는 Google이 업스케일하며 더 비쌉니다. |
요금
편집은 원본 길이를 초 단위로 올림해 최소 3초, 최대 10초로 과금합니다. 단가는 해상도에 따라 정해지며 생성 단가보다 높습니다. 원본이 10초를 넘으면 10초에서 자릅니다. 실패하거나 거부된 편집에는 요금을 부과하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.0576 / 초 |
| $0.1248 / 초 |
| $0.1752 / 초 |
| $0.3264 / 초 |
활용 사례
대사가 있는 시장의 짧은 장면
요리사와 한 가지 동작, 따옴표로 묶은 짧은 대사를 적고, 기름이 지글거리는 소리와 비 오는 시장의 분위기를 요청합니다.
호텔 도착 또는 출발
부두의 첫 이미지에서 보트가 출발하도록 움직이게 하거나, 마지막 구도가 정해져 있다면 종료 이미지를 추가합니다.
같은 캐릭터가 다시 등장하는 장면
참조 인물 사진을 사용해 기존 두 인물을 해 질 녘 식당칸 같은 새로운 배경에 배치합니다.
공연 배경을 다른 무대로
촬영된 동작을 유지하면서 스튜디오를 호숫가로 바꾸도록 영상 편집에 요청합니다.
프롬프트 가이드 및 실전 팁
시작 자료에 맞는 엔드포인트 선택
새 장면에는 텍스트, 애니메이션에는 첫 정지 이미지, 시각적 방향에는 참조 자료, 특정 수정에는 기존 영상을 사용합니다.
장면 구성 명확히 전달
Google에 따르면 모델은 기본적으로 여러 샷을 만들 수 있습니다. 한 테이크를 원하면 ‘no scene cuts’를 추가하고, 말할 대사는 따옴표로 묶습니다.
참조마다 역할 지정
‘Image 2의 장소 사용’ 또는 ‘Video 1처럼 움직이기’라고 적어 각 업로드의 역할을 프롬프트로 설명합니다.
해상도를 높이기 전에 작은 초안 검토
제공되는 요금 중 가장 낮은 360p로 아이디어를 시험합니다. 1080p와 4K는 Google이 업스케일하며 더 높은 요금이 적용됩니다.
편집 지시의 범위 좁히기
Google은 단순한 변경 지시 뒤에 ‘Keep everything else the same.’을 덧붙이도록 권장합니다. 편집은 10초에서 자르므로 전송 전에 원본 길이를 확인합니다.
소개
Gemini Omni 1.2 Flash 영상 편집은 이미 보유한 영상에서 시작합니다. video_url, 필수 prompt, 출력 해상도를 제공합니다. 자체 테스트에서는 회색 스튜디오를 달빛 비추는 호숫가 무대로 바꾸면서 무용수와 동작을 유지했습니다.
편집 길이는 원본을 따르되 10초 이후 구간은 제거합니다. 자체 테스트에서 12초 원본으로 10.03초 결과가 생성되었습니다. 편집에는 길이나 화면비 필드가 없습니다. 원본 초 수를 올림해 최소 3초, 최대 10초로 과금하며, 선택한 해상도에 따라 생성보다 높은 편집 단가를 적용합니다.
주요 기능 및 특징
- 기존 영상에 글로 설명한 시각적 변경 사항을 적용합니다.
- 원본 길이를 따르며 긴 영상은 10초에서 자릅니다.
- 360p·720p 직접 출력 또는 더 높은 요금의 Google 1080p·4K 업스케일을 선택합니다.
- AAC 오디오 트랙을 포함한 24 fps MP4 결과를 받습니다.
- 변경 사항 이외에는 모두 보존하라는 Google의 권장 문구로 요청 범위를 명확히 합니다.
활용 사례
- 회색 연습 스튜디오를 달빛 비추는 호숫가 무대로 바꿉니다.
- 촬영된 무용 동작을 유지하도록 요청하면서 안개 낀 배경의 변형을 검토합니다.
- 기존의 짧은 공연에 다른 시각적 배경을 적용해 보고 원하는 버전을 선택합니다.
프롬프트 작성 가이드와 팁
- 간단한 편집 프롬프트를 권장하는 Google의 안내에 따라 ‘스튜디오를 호숫가 무대로 바꿉니다’처럼 변경 한 가지로 시작합니다.
- ‘수면 위의 옅은 안개’처럼 구체적인 시각적 특성을 적어 새 배경의 방향을 정합니다.
- 요청한 수정 범위를 제한하도록 Google이 제안한 ‘Keep everything else the same.’으로 마무리합니다.
- 공연의 움직임이 이어지는지 검토할 때는 ‘원래 동작을 유지합니다’처럼 보존할 요소를 지정합니다.
- 업로드 전에 원하는 구간을 준비합니다. ‘이 장면을 달빛 아래로 바꿉니다’ 같은 지시를 해도 첫 10초 이후의 내용은 잘려 나갑니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/gemini-omni-1.2-flash/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
