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

# Gemini Omni 1.2 Flash 비디오 생성

> - 모델 ID: `gemini_omni_1_2_flash`
- 비동기 처리 모드, 후속 조회를 위한 태스크 ID 반환
- 텍스트 기반 비디오 생성 또는 최대 3장의 참조 이미지 지원
- 네이티브 720p, 길이 3–15초 중 선택; 11–15초는 9:16만 지원


> [!NOTE]
>
> 출력은 항상 720p H.264 MP4입니다: 가로 1280×720, 세로 720×1280. 1080p / 4K, 참조 비디오, 첫/마지막 프레임 지정은 지원하지 않습니다.

## Authorizations

**Authorization** `string` *required*

모든 엔드포인트는 Bearer Token 인증이 필요합니다.

API Key 받기:

[API Key 관리 페이지](https://aireiter.com/keys)에서 API Key를 받으세요.

사용할 때 요청 헤더에 다음을 추가하세요:

```
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required*

모델 이름. 항상 `gemini_omni_1_2_flash`를 전달하세요.

**params** `object` *required*

모델 파라미터 객체입니다.

**params 객체 속성**

**prompt** `string` *required*

비디오 생성을 위한 텍스트 설명. 필수.

**video\_length** `string` (default: 8)

생성할 비디오 길이(초). `"3"`부터 `"15"`까지의 정수 초 문자열만 허용됩니다:

* `"3"` / `"4"` / `"5"` / `"6"` / `"7"`
* `"8"` - 기본값
* `"9"` / `"10"` / `"11"` / `"12"` / `"13"` / `"14"` / `"15"`

> [!WARNING]
>
> 열거형 검증은 문자열을 요구합니다. 숫자 `8`이 아닌 `"8"`을 전달하세요. `"11"`\~`"15"`는 `aspect_ratio`가 `9:16`일 때만 사용할 수 있습니다.

**aspect\_ratio** `string` (default: 16:9)

비디오 화면비:

* `16:9` - 가로 1280×720, 기본값
* `9:16` - 세로 720×1280

길이가 11–15초인 경우 `9:16`만 전달할 수 있으며, `16:9`는 거부됩니다.

**image\_url** `string | string[]`

참조 이미지 URL이며, 공개 인터넷에서 직접 접근 가능해야 합니다. 단일 문자열도 허용됩니다. 생략하면 텍스트 기반 비디오 생성입니다.

* 최대 3장, 4번째 이미지는 거부됩니다
* 짧은 변 300px 이상, 장당 10MB 이하

참조 이미지는 피사체와 스타일을 정하는 데 사용되며 첫/마지막 프레임이 아닙니다. 영상이 특정 이미지로 시작하거나 끝나도록 강제되지 않습니다.

**out\_task\_id** `string` *required*

요청자 작업 ID입니다.

사용자 정의 작업 식별자이며 필수 항목입니다. 영문자, 숫자, 밑줄(\_), 하이픈(-)만 지원하며 길이는 1-64자입니다. 이후 이 ID를 사용하여 작업 상태와 결과를 조회할 수 있습니다.

## Response

**out\_task\_id** `string`

호출자 작업 ID. 결과 조회에 사용할 수 있습니다.

**status** `string`

초기 상태. 보통 `"pending"`.

**estimated\_credits** `number`

이 작업의 예상 소모 크레딧.

**created\_at** `string`

생성 시간. ISO 형식.

## Query Task

이 모델은 비동기 비디오 생성 방식입니다. 작업을 제출한 후 `out_task_id`를 사용하여 작업 상태를 조회하세요. [작업 상태 조회](https://docs.aireiter.com/ko/api-reference/tasks/status.md)도 참조할 수 있습니다.

**out\_task\_id** `string` *required*

작업 제출 시 전달된 요청자 작업 ID입니다.

```bash theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "out_task_id": "omni_12_t2v_123456"
  }'
```

조회가 성공하여 완료되면 응답의 `output` 배열에 생성된 비디오가 포함되며, 요소에는 `video` 필드가 포함됩니다.

## 파라미터 대조표

| 입력 | `image_url` | `video_length` | `aspect_ratio` |
| - | - | - | - |
| 텍스트 기반 생성 | 전달하지 않거나 빈 배열 | `"3"`–`"10"` | `16:9` 또는 `9:16` |
| 텍스트 기반 생성(장시간) | 전달하지 않거나 빈 배열 | `"11"`–`"15"` | `9:16`만 |
| 참조 이미지 | 1–3장 | `"3"`–`"10"` | `16:9` 또는 `9:16` |
| 참조 이미지(장시간) | 1–3장 | `"11"`–`"15"` | `9:16`만 |

지원하지 않는 필드: `resolution`(720p 고정), `video_url`(참조 비디오 미지원).

## Request Examples

```bash cURL (텍스트 기반 생성) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini_omni_1_2_flash",
    "params": {
      "prompt": "햇살 가득한 해변을 달리는 골든 리트리버, 트래킹 숏, 사실적인 스타일",
      "aspect_ratio": "16:9",
      "video_length": "8"
    },
    "out_task_id": "omni_12_t2v_123456"
  }'
```

```bash cURL (참조 이미지 3장) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini_omni_1_2_flash",
    "params": {
      "prompt": "참조 이미지의 인물과 의상을 유지하며 정원을 걷기",
      "image_url": [
        "https://example.com/ref-1.jpg",
        "https://example.com/ref-2.jpg",
        "https://example.com/ref-3.jpg"
      ],
      "aspect_ratio": "16:9",
      "video_length": "6"
    },
    "out_task_id": "omni_12_img3_123456"
  }'
```

```bash cURL (15초 세로) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini_omni_1_2_flash",
    "params": {
      "prompt": "도시 야경 타임랩스, 차량 불빛 궤적, 세로 구도",
      "aspect_ratio": "9:16",
      "video_length": "15"
    },
    "out_task_id": "omni_12_t2v_15s_123456"
  }'
```

```python Python theme={null}
import requests

url = "https://aireiter.com/api/openapi/submit"

payload = {
    "model": "gemini_omni_1_2_flash",
    "params": {
        "prompt": "햇살 가득한 해변을 달리는 골든 리트리버, 트래킹 숏, 사실적인 스타일",
        "aspect_ratio": "16:9",
        "video_length": "8"
    },
    "out_task_id": "omni_12_t2v_123456"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript JavaScript theme={null}
const url = "https://aireiter.com/api/openapi/submit";

const payload = {
  model: "gemini_omni_1_2_flash",
  params: {
    prompt: "햇살 가득한 해변을 달리는 골든 리트리버, 트래킹 숏, 사실적인 스타일",
    aspect_ratio: "16:9",
    video_length: "8"
  },
  out_task_id: "omni_12_t2v_123456"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
```

```go Go theme={null}
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://aireiter.com/api/openapi/submit"

    payload := map[string]interface{}{
        "model": "gemini_omni_1_2_flash",
        "params": map[string]interface{}{
            "prompt":       "햇살 가득한 해변을 달리는 골든 리트리버, 트래킹 숏, 사실적인 스타일",
            "aspect_ratio": "16:9",
            "video_length": "8",
        },
        "out_task_id": "omni_12_t2v_123456",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

```java Java theme={null}
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://aireiter.com/api/openapi/submit";

        String payload = """
            {
              "model": "gemini_omni_1_2_flash",
              "params": {
                "prompt": "햇살 가득한 해변을 달리는 골든 리트리버, 트래킹 숏, 사실적인 스타일",
                "aspect_ratio": "16:9",
                "video_length": "8"
              },
              "out_task_id": "omni_12_t2v_123456"
            }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}
```

```php PHP theme={null}
<?php

$url = "https://aireiter.com/api/openapi/submit";

$payload = [
    "model" => "gemini_omni_1_2_flash",
    "params" => [
        "prompt" => "햇살 가득한 해변을 달리는 골든 리트리버, 트래킹 숏, 사실적인 스타일",
        "aspect_ratio" => "16:9",
        "video_length" => "8"
    ],
    "out_task_id" => "omni_12_t2v_123456"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
```

```json 200 theme={null}
{
  "statusCode": 200,
  "message": "",
  "data": {
      "out_task_id": "omni_12_t2v_123456",
      "status": "pending",
      "estimated_credits": "<예상 소모 크레딧>",
      "created_at": "2026-11-18T06:03:28.242Z"
  }
}
```

```json 400 theme={null}
  {
      "statusCode": 400,
      "message": "요청 매개변수가 올바르지 않습니다",
      "ok": false
  }
```

```json 401 theme={null}
{
  "error": {
    "code": 401,
    "message": "인증에 실패했습니다. API 키를 확인해 주세요"
  }
}
```

```json 433 theme={null}
  {
    "error": {
      "code": 433,
      "message": "계정 잔액이 부족합니다. 충전 후 다시 시도해 주세요"
    }
  }
```

```json 500 theme={null}
{
  "error": {
    "code": 500,
    "message": "서버 내부 오류가 발생했습니다. 잠시 후 다시 시도해 주세요"
  }
}
```


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