> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini Omni 1.2 Flash 비디오 API: 요금과 사용법

> LaoZhang API에서 Google Gemini Omni 1.2 Flash를 호출합니다. OpenAI 방식 /v1/videos로 텍스트, 첫 프레임 이미지, 참조 이미지 작업을 만들고 소리가 들어간 MP4를 내려받는 방법을 안내합니다. Google 계정은 필요 없습니다.

Gemini Omni 1.2 Flash는 Google의 비디오 생성 모델로, 클립에 사운드트랙이 들어가고 프롬프트에 적은 대사를 인물이 직접 말하며 최대 1080p로 출력합니다. LaoZhang API는 비디오당 과금하며 360p는 \$0.10, 720p는 \$0.30, 1080p는 \$0.45이고 3\~10초 모두 같은 가격입니다.

| 항목 | 내용 |
| - | - |
| 모델 ID | `gemini-omni-1.2-flash` |
| 작업 생성 | `POST /v1/videos`, JSON 또는 multipart |
| 작업 조회 | `GET /v1/videos/{id}`. 완료되면 `video_url`을 읽습니다 |
| 다운로드 | `video_url`을 직접 쓰거나 `GET /v1/videos/{id}/content` |
| 토큰 그룹 | `default` (과금 방식은 사용량 우선) |
| 가격 | 비디오 단위 과금이며 해상도만 가격을 정합니다. 아래 요금 절 참고 |
| 출력 | 3\~10초, 360p·720p·1080p, 16:9 또는 9:16, 24fps, 사운드트랙 포함 |
| 이미지 입력 | 최대 6장. 아래 첫 프레임 이미지로 비디오 만들기, 참조 이미지로 만들기 절 참고 |
| 보관 기간 | 비디오 링크는 7일간 유지됩니다 |
| 경로 | 독자적으로 연동했으며 비디오당 별도 가격이 적용됩니다. Google 계정은 필요 없습니다 |

<video controls preload="none" poster="/images/samples/gemini-omni-en-t2v.jpg" src="https://media.laozhang.ai/samples/video/gemini-omni-en-t2v-720p-10s.mp4" />

아래 텍스트로 비디오 만들기 예제의 출력: gemini-omni-1.2-flash, 720p, 10초, 16:9. 인물이 프롬프트에 적은 대사를 말합니다

## 요금과 모델 선택

### 요금

Gemini Omni 1.2 Flash는 비디오 한 편 단위로 과금하며, 가격은 `resolution`만으로 정해집니다.

| `resolution` | 가로 / 세로 출력 | 비디오당 |
| - | - | -: |
| `360p` | 640×360 / 360×640 | \$0.10 |
| `720p`(기본값) | 1280×720 / 720×1280 | \$0.30 |
| `1080p` | 1920×1080 / 1080×1920 | \$0.45 |

다음 항목은 가격을 바꾸지 않습니다.

* `seconds`: 3\~10초 모두 같은 가격입니다. 10초 720p 클립은 초당 \$0.03꼴입니다.
* 이미지: 첫 프레임이나 참조 이미지를 보내도 가격은 같습니다.
* `reasoning_effort`와 종횡비: 어떤 값을 골라도 가격은 같습니다.

과금 방식은 다음과 같습니다.

* 작업을 만들 때 과금되며, 실패한 작업은 전액 환불됩니다. 콘텐츠 심사에서 차단된 작업도 환불됩니다.
* 파라미터 오류로 제출 단계에서 거부된 요청은 과금되지 않습니다.
* 다시 제출하면 새 작업이 만들어져 다시 과금되므로, 자체 작업 ID와 작업 `id`의 대응 관계를 보관하세요.

작업별 실제 청구 금액은 [호출 로그](https://api.laozhang.ai/log)에서 확인할 수 있습니다.

**10초 클립의 가격은 Google 공식 가격의 약 43%입니다.** Google의 Gemini API는 초당 과금합니다. 10초 클립 기준으로 Google 공식 가격과 LaoZhang API 가격을 비교하면 다음과 같습니다(2026년 11월 11일 확인, 출처는 페이지 끝의 관련 문서와 출처 절).

| 10초 클립 | Google 공식 가격 | LaoZhang API |
| - | -: | -: |
| 360p | \$0.23 | \$0.10 |
| 720p | \$0.70 | \$0.30 |
| 1080p | \$1.04 | \$0.45 |

### 비디오 모델 고르기

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](https://docs.laozhang.ai/ko/api-capabilities/muse-video-generation.md)를 쓰세요. 엔드포인트가 같은 `/v1/videos`라서 같은 토큰으로 모델만 바꾸면 됩니다.
* **2K, 참조 비디오, 참조 오디오가 필요할 때**: [MiniMax H3](https://docs.laozhang.ai/ko/api-capabilities/minimax-h3-video-generation.md)를 쓰세요.

모델별 5초·10초 클립 비용과 엔드포인트는 [비디오 API 비교](https://docs.laozhang.ai/ko/api-capabilities/video-generation-guide.md)에 정리되어 있습니다.

## 샘플 출력

아래 클립은 편집하지 않은 Gemini Omni 1.2 Flash 출력이며 모델이 만든 사운드트랙이 들어 있습니다. 클립을 눌러 재생하세요. 각 캡션에는 해상도, 길이, 종횡비, 프롬프트가 있습니다.

[Muse 샘플 출력](https://docs.laozhang.ai/ko/api-capabilities/muse-video-generation.md)과 [MiniMax H3 샘플 출력](https://docs.laozhang.ai/ko/api-capabilities/minimax-h3-video-generation.md)은 같은 프롬프트를 쓰므로 장면별로 모델을 비교할 수 있습니다.

<video controls preload="none" poster="/images/samples/gemini-omni-sample-fox-720p-5s.jpg" src="https://media.laozhang.ai/samples/video/gemini-omni-fox-720p-5s.mp4" />

720p, 5초, 16:9. 프롬프트: A red fox walking through snowy forest at sunrise, cinematic

<video controls preload="none" poster="/images/samples/gemini-omni-sample-paper-boat-720p-10s.jpg" src="https://media.laozhang.ai/samples/video/gemini-omni-paper-boat-720p-10s.mp4" />

720p, 10초, 16:9. 프롬프트: A paper boat drifts down a rainy city gutter, then sails into a small sunny pond

<video controls preload="none" poster="/images/samples/gemini-omni-sample-hot-air-balloon-1080p-10s.jpg" src="https://media.laozhang.ai/samples/video/gemini-omni-hot-air-balloon-1080p-10s.mp4" />

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

<video controls preload="none" poster="/images/samples/gemini-omni-sample-cyclist-1080p-10s-9x16.jpg" src="https://media.laozhang.ai/samples/video/gemini-omni-cyclist-1080p-10s-9x16.mp4" />

1080p, 10초, 9:16 세로. 프롬프트: A cyclist rides through a coastal town from morning to sunset: market, harbor, cliff road, lighthouse

## 시작하기 전에

### API 키 만들기

[토큰 관리](https://api.laozhang.ai/token)에서 다음 설정으로 API 키(콘솔에서는 '토큰'이라고 부릅니다)를 추가하세요.

| 설정 | 선택 |
| - | - |
| 그룹 | `default` |
| 과금 방식 | 사용량 우선(콘솔 표시: 按量优先, 권장) 또는 건당 과금(按次计费). 사용량 과금(按量计费)만 설정한 키는 호출할 수 없습니다 |
| 팁 | 비디오 전용 키를 따로 만들면 호출 로그에서 청구 내역과 작업을 맞춰 보기 쉽습니다 |

Google 계정이나 Gemini API 키, 별도의 비디오 전용 그룹은 필요하지 않습니다. [Muse](https://docs.laozhang.ai/ko/api-capabilities/muse-video-generation.md)에 쓰던 키가 있다면 그대로 호출할 수 있습니다.

### 작동 방식

**1. 작업 생성**

최소한 `model`과 `prompt`를 넣어 `POST /v1/videos`를 호출합니다. 이 엔드포인트는 비동기라서 비디오가 완성되기를 기다리지 않고 몇 초 안에 작업 `id`를 반환합니다. 이 값을 저장하세요.

**2. 상태 조회**

5~~10초마다 `GET /v1/videos/{id}`를 호출해 `status`를 읽습니다. 360p의 짧은 클립은 보통 30~~60초, 720p 10초 클립은 약 1분, 1080p 10초 클립은 약 1.5\~2분 걸립니다.

**3. 결과 다운로드**

`status`가 `completed`가 되면 `video_url`에서 MP4를 내려받습니다. 다운로드에는 `Authorization` 헤더가 필요 없습니다.

> [!WARNING]
>
> **최대 15분 동안 조회하고, 작업이 끝나기 전에는 다시 제출하지 마세요.**
>
> * 제출과 조회 모두 바로 응답하므로 HTTP 타임아웃을 길게 잡을 필요가 없습니다.
> * `status`가 `queued` 또는 `in_progress`인 동안은 계속 확인하세요.
> * 조회를 멈췄다면 나중에 같은 `id`로 다시 확인하세요. 다시 제출하면 새 작업이 만들어져 다시 과금됩니다.
> * 30분이 지나도 끝나지 않은 작업은 실패로 처리되며 전액 환불됩니다.

### 환경 설정

cURL 예제는 응답에서 필드를 읽기 위해 `jq`를 사용합니다(macOS에서는 `brew install jq`). 먼저 키와 base URL을 설정하세요.

```bash theme={null}
export LAOZHANG_API_KEY="LaoZhang API 키"
export BASE_URL="https://api.laozhang.ai"
```

## 비디오 만들기

### 텍스트로 비디오 만들기

아래 요청의 프롬프트는 위 샘플 비디오를 만든 영어 프롬프트 그대로입니다.

```bash theme={null}
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "gemini-omni-1.2-flash",
    "prompt": "A street musician plays the violin under a street lamp on a rain-soaked cobblestone street at dusk. The camera slowly pushes in. She stops, smiles at the camera and says: \"This one is for you.\" Soft rain and violin in the background.",
    "resolution": "720p",
    "seconds": "10",
    "aspect_ratio": "16:9"
  }' | tee omni-create.json

export VIDEO_ID=$(jq -r '.id' omni-create.json)
```

요청이 성공하면 대기 중인 작업이 반환됩니다.

```json theme={null}
{
  "id": "task_pmz6yURlFEdpV7oQREUQWFMvYe0ZNN0j",
  "object": "video",
  "model": "gemini-omni-1.2-flash",
  "status": "queued",
  "progress": 0,
  "resolution": "720p",
  "seconds": "10",
  "created_at": 1794395489
}
```

선택 필드 세 가지에는 모두 기본값이 있습니다.

* `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이어야 합니다.

```bash theme={null}
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "gemini-omni-1.2-flash",
    "prompt": "로봇 셰프가 냄비의 수프를 젓다가 거품기를 들어 올리며 밝게 말합니다. \"저녁 준비 거의 다 됐어요!\" 카메라가 천천히 다가가고 냄비에서 김이 피어오릅니다.",
    "resolution": "720p",
    "seconds": "6",
    "image": "https://example.com/robot-chef.jpg"
  }'
```

로컬 파일은 multipart 폼 데이터로 바로 올릴 수 있습니다. 필드 이름은 `input_reference`입니다.

```bash theme={null}
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F model=gemini-omni-1.2-flash \
  -F prompt="Waves crash against the rocks below the lighthouse, clouds drift slowly and the lighthouse beam turns on" \
  -F resolution=360p \
  -F seconds=5 \
  -F input_reference=@./lighthouse.jpg
```

`-F`로 업로드할 때는 `Content-Type: application/json`을 설정하지 마세요. 이미지는 한 장당 최대 10MB이며 JPEG, PNG, WebP를 지원합니다.

### 참조 이미지로 만들기

`reference_images`에 이미지를 여러 장 보내면 모델이 이미지 속 인물, 사물, 장면을 한 클립에 담습니다. 프롬프트에서는 배열 순서대로 `image 1`, `image 2`처럼 가리킵니다.

```bash theme={null}
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "gemini-omni-1.2-flash",
    "prompt": "The robot chef from image 2 walks into the ramen shop from image 1 and sits down at the counter. The cat sleeping next to it wakes up.",
    "resolution": "720p",
    "seconds": "8",
    "reference_images": [
      "https://example.com/ramen-shop.jpg",
      "https://example.com/robot-chef.jpg"
    ]
  }'
```

* `image`와 `reference_images`는 합쳐서 최대 6장입니다. 7장째부터는 오류가 반환됩니다.
* multipart로 올릴 때 참조 이미지의 필드 이름은 `reference_images`이며 여러 번 반복해 보낼 수 있습니다.
* 두 필드는 함께 보낼 수 있습니다. `image`가 시작 장면을 정하고, 참조 이미지는 등장할 인물이나 사물을 제공합니다.
* 실제 인물과 관련된 제한은 아래 콘텐츠 제한 절에 있습니다.

### 세로 비디오와 1080p 만들기

세로 비디오는 `"aspect_ratio": "9:16"`을 보냅니다. `size`로 해상도와 비율을 한 번에 지정할 수도 있습니다. 아래는 1080p 세로 비디오 요청입니다.

```bash theme={null}
curl -s -X POST "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "gemini-omni-1.2-flash",
    "prompt": "A cyclist rides through a coastal town from morning to sunset: market, harbor, cliff road, lighthouse",
    "size": "1080x1920",
    "seconds": "10"
  }'
```

`size`에 쓸 수 있는 값은 아래 요청 필드 절에 있습니다. 가격은 해당하는 해상도로 계산하므로 `1080x1920`은 1080p 가격인 \$0.45입니다.

## 조회와 다운로드

### 작업 조회

```bash theme={null}
curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY"
```

비디오를 만드는 동안 `status`는 `in_progress`이고 `progress`에 대략적인 진행률이 표시됩니다.

```json theme={null}
{
  "id": "task_cpg5YjZdGpf5G64hpcehVFip3yEzBGmJ",
  "object": "video",
  "model": "gemini-omni-1.2-flash",
  "status": "in_progress",
  "progress": 24,
  "resolution": "360p",
  "seconds": "3",
  "size": "640x360",
  "created_at": 1794395880
}
```

완료되면 작업에 `video_url`이 포함됩니다.

```json theme={null}
{
  "id": "task_cpg5YjZdGpf5G64hpcehVFip3yEzBGmJ",
  "object": "video",
  "model": "gemini-omni-1.2-flash",
  "status": "completed",
  "progress": 100,
  "resolution": "360p",
  "seconds": "3",
  "size": "640x360",
  "created_at": 1794395880,
  "completed_at": 1794395908,
  "video_url": "https://media.laozhang.ai/videos/omni-video_b1c75730eec94afecd7a03e6-8a6288ae03f4.mp4"
}
```

실패한 작업은 `status: "failed"`이고 사유가 `error.message`에 있습니다. 청구 금액은 이미 환불되었습니다.

```json theme={null}
{
  "id": "task_bgrPGFRI5wEwlOW0XrCy5b29xTGHlKbt",
  "object": "video",
  "model": "gemini-omni-1.2-flash",
  "status": "failed",
  "progress": 100,
  "resolution": "360p",
  "seconds": "3",
  "size": "640x360",
  "created_at": 1794395882,
  "error": {
    "code": "video_generation_failed",
    "message": "input_reference must be a public internet link. This request is not charged."
  }
}
```

### 비디오 다운로드

```bash theme={null}
curl -L -o omni-video.mp4 "$(curl -s "$BASE_URL/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" | jq -r '.video_url')"
```

`Authorization` 헤더와 함께 `GET /v1/videos/{id}/content`를 호출해도 MP4 파일이 반환됩니다. 비디오 링크는 7일간 유지되므로 오래 쓸 파일은 내려받아 직접 보관하세요.

### 최소 Python 클라이언트

`requests`가 필요합니다(`pip install requests`).

```python theme={null}
import os
import time

import requests

BASE_URL = "https://api.laozhang.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"}

task = requests.post(
    f"{BASE_URL}/v1/videos",
    headers=HEADERS,
    json={
        "model": "gemini-omni-1.2-flash",
        "prompt": "A street musician plays the violin under a street lamp on a rain-soaked cobblestone street at dusk. The camera slowly pushes in. She stops, smiles at the camera and says: \"This one is for you.\" Soft rain and violin in the background.",
        "resolution": "720p",
        "seconds": "10",
        "aspect_ratio": "16:9",
    },
    timeout=120,
)
task.raise_for_status()
video_id = task.json()["id"]

deadline = time.time() + 15 * 60
while True:
    video = requests.get(f"{BASE_URL}/v1/videos/{video_id}", headers=HEADERS, timeout=60).json()
    if video["status"] == "completed":
        break
    if video["status"] == "failed":
        raise RuntimeError(video["error"]["message"])
    if time.time() > deadline:
        raise TimeoutError(f"{video_id} 작업이 아직 진행 중입니다. 나중에 같은 id로 계속 조회하세요")
    time.sleep(5)

with open("omni-video.mp4", "wb") as f:
    f.write(requests.get(video["video_url"], timeout=300).content)
print("omni-video.mp4 저장 완료,", video["size"], video["seconds"], "초")
```

## API 레퍼런스

### 요청 필드

| 필드 | 필수 | 설명 |
| - | - | - |
| `model` | 필수 | `gemini-omni-1.2-flash` |
| `prompt` | 필수 | 화면, 동작, 대사, 소리에 대한 설명. 최대 20,000자 |
| `resolution` | 선택 | `360p`, `720p`(기본값), `1080p`. 가격을 정합니다 |
| `seconds` | 선택 | 3\~10의 정수이며 기본값은 10. 가격에 영향을 주지 않습니다 |
| `aspect_ratio` | 선택 | `16:9`(기본값) 또는 `9:16` |
| `size` | 선택 | 픽셀 단위로 해상도와 비율을 함께 지정합니다. 쓸 수 있는 값은 아래 표 참고 |
| `image` | 선택 | 시작 장면으로 쓸 이미지 한 장. multipart 필드 이름은 `input_reference`입니다 |
| `reference_images` | 선택 | 참조 이미지 배열. `image`와 합쳐 최대 6장 |
| `reasoning_effort` | 선택 | `low` 또는 `high`. 가격에 영향을 주지 않습니다 |

`size` 값이 가리키는 해상도와 비율입니다.

| `size` | 같은 설정 | 비디오당 |
| - | - | -: |
| `640x360` / `360x640` | `360p`, 16:9 / 9:16 | \$0.10 |
| `1280x720` / `720x1280` | `720p`, 16:9 / 9:16 | \$0.30 |
| `1920x1080` / `1080x1920` | `1080p`, 16:9 / 9:16 | \$0.45 |

지원하지 않는 입력을 보내면 제출 단계에서 바로 오류가 반환되며 과금되지 않습니다.

* 참조 비디오, 참조 오디오, 마지막 프레임(`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 워터마크가 들어 있습니다. 화면에 보이는 워터마크는 없습니다.

### 작업 상태

| `status` | 의미 | 다음 단계 |
| - | - | - |
| `queued` | 접수되어 생성을 기다리는 중 | 계속 조회 |
| `in_progress` | 생성 중. `progress`는 대략적인 진행률 | 계속 조회 |
| `completed` | 완료 | `video_url`에서 다운로드 |
| `failed` | 실패하고 환불됨 | `error.message`에 맞게 요청을 고쳐 새 작업 생성 |

### 콘텐츠 제한

다음 두 종류의 콘텐츠는 모델이 차단합니다. 차단된 작업은 `failed`로 반환되고 전액 환불됩니다.

* 실제 인물: 프롬프트에 실제 인물의 이름이 들어 있으면 차단됩니다. 모델은 실제 인물의 모습도 만들지 않으므로 유명인 사진 같은 이미지는 차단될 수 있습니다.
* 성적인 콘텐츠와 저작권으로 보호되는 캐릭터: 두 가지 모두 차단됩니다.

AI로 만든 인물 이미지처럼 일반적인 인물 이미지는 그대로 쓸 수 있습니다.

### 오류

오류 메시지는 영어로 반환됩니다. 아래 표는 오류가 나타나는 위치별로 정리한 것입니다.

| 나타나는 위치 | `message` 시작 부분 | 해결 |
| - | - | - |
| 제출 시 HTTP 400 | `seconds must be a whole number from 3 to 10.` | `seconds`를 3\~10으로 바꾸세요 |
| 제출 시 HTTP 400 | `resolution must be one of 360p, 720p, 1080p` | 2K와 4K는 지원하지 않습니다. 세 해상도 중 하나를 쓰세요 |
| 제출 시 HTTP 400 | `aspect_ratio must be one of 16:9, 9:16.` | `16:9` 또는 `9:16`으로 바꾸세요 |
| 제출 시 HTTP 400 | `video_url is not supported` | 참조 비디오 필드를 빼고 프롬프트와 이미지만 보내세요 |
| 제출 시 HTTP 400 | `Send at most 6 images in total` | 이미지를 6장 이하로 줄이세요 |
| 작업 `failed` | `Could not download …` | 누구나 내려받을 수 있는 이미지 링크를 쓰거나 데이터 URL로 보내세요 |
| 작업 `failed` | `The prompt or images were blocked` | 실제 인물의 이름이나 사진, 정책에 어긋나는 내용을 빼고 다시 시도하세요 |
| 작업 `failed` | `Video generation failed because of a temporary service error.` | 그대로 다시 제출하세요 |

## 자주 묻는 질문

### 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도 되나요?

한 편은 3~~10초이고 해상도는 최대 1080p입니다. 2K와 4K는 지원하지 않습니다. 20~~60초의 연속된 클립이 필요하면 [Muse](https://docs.laozhang.ai/ko/api-capabilities/muse-video-generation.md)를, 2K가 필요하면 [MiniMax H3](https://docs.laozhang.ai/ko/api-capabilities/minimax-h3-video-generation.md)를 쓰세요.

### Gemini Omni 1.2 Flash 비디오에 워터마크가 있나요?

화면에 보이는 워터마크는 없습니다. 파일에는 AI로 만든 비디오임을 표시하는 Google의 C2PA 콘텐츠 자격 증명과 눈에 보이지 않는 SynthID 워터마크가 들어 있습니다.

### Gemini Omni 1.2 Flash 비디오 생성에는 얼마나 걸리나요?

360p의 짧은 클립은 보통 30~~60초, 720p 10초 클립은 약 1분, 1080p 10초 클립은 약 1.5~~2분 걸립니다. 엔드포인트가 비동기라서 제출과 조회는 바로 응답하며, 5\~10초마다 조회하면 됩니다.

### Muse나 Sora 2 코드를 Gemini Omni 1.2 Flash로 바꾸려면?

엔드포인트가 같으므로 작업 생성과 조회 경로, 토큰은 그대로 둡니다. 바꿀 것은 세 가지입니다.

* `model`을 `gemini-omni-1.2-flash`로 바꿉니다.
* `seconds`를 3\~10 사이로 맞춥니다.
* 360p나 1080p가 필요하면 `resolution`을 추가합니다. 생략하면 720p입니다.

## 관련 문서와 출처

* [비디오 생성 API 비교와 가격](https://docs.laozhang.ai/ko/api-capabilities/video-generation-guide.md): 비디오 모델별 한 편 비용, 엔드포인트, 토큰 그룹 비교
* [Muse 비디오 API](https://docs.laozhang.ai/ko/api-capabilities/muse-video-generation.md): 같은 엔드포인트로 만드는 20\~60초 클립과 비디오 이어 만들기
* [모델 및 가격](https://docs.laozhang.ai/ko/models.md)
* [Gemini Omni 1.2 Flash 출시 공지(영어)](https://docs.laozhang.ai/en/announcements/gemini-omni-1-2-flash-2026-11.md)
* [Google: Gemini Omni 1.2 Flash 발표](https://blog.google/innovation-and-ai/technology/developers-tools/introducing-gemini-omni-1-2-flash/)(모델 기능, 2026년 11월 11일 확인)
* [Google: Gemini API 가격](https://ai.google.dev/gemini-api/docs/pricing)(공식 초당 가격, 2026년 11월 11일 확인)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.