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

# Gemini Omni 1.1 동영상 생성 및 편집

> 공식 Gemini Omni 1.1 Flash Preview로 3-10초 동영상을 4가지 해상도로 생성, 편집, 연장

* `model`을 `gemini-omni-1.1-flash-preview-official`로 지정합니다
* 텍스트→동영상, 이미지→동영상, 참조 동영상 생성, 동영상 편집, 동영상 연장을 지원합니다
* 참조 이미지 최대 10장과 입력 동영상 최대 3개; 이미지와 동영상은 하나의 요청에서 함께 사용할 수 있습니다
* 길이 3-10초; 해상도 360p / 720p / 1080p / 4K
* 비동기 태스크 API이며 제출 후 태스크 ID로 결과를 조회합니다

> [!NOTE]
>
> 중국 본토 사용자는 예시 도메인을 `https://toapis.cn`으로 바꿀 수 있습니다.

> [!WARNING]
>
> 로컬 이미지는 [이미지 업로드 API](https://docs.toapis.com/docs/ko/api-reference/uploads/images.md), 로컬 동영상은 [동영상 업로드 API](https://docs.toapis.com/docs/ko/api-reference/uploads/videos.md)로 먼저 업로드한 뒤 반환된 URL을 전달하세요. base64 미디어 데이터를 직접 보내지 마세요.

## Authorizations

**Authorization** `string` *required*

Bearer Token 인증을 사용합니다:

```
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required* (default: gemini-omni-1.1-flash-preview-official)

모델 이름. `gemini-omni-1.1-flash-preview-official`을 사용합니다.

**prompt** `string` *required*

생성, 편집 또는 연장할 동영상 프롬프트.

**duration** `integer` (default: 6)

동영상 길이(초), `3`-`10` 정수. `extend` 태스크에서는 연장 길이를 의미하며 생략 시 약 10초입니다.

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

화면 비율:

* `16:9` 가로
* `9:16` 세로

`edit` 및 `extend` 태스크에서는 전송하지 않습니다.

**resolution** `string` (default: 720p)

동영상 해상도:

* `360p`
* `720p`
* `1080p`
* `4K`

**image\_urls** `string[]`

참조 이미지 URL 배열, 최대 `10`장. 생략하면 텍스트→동영상입니다. `video_list`와 함께 사용할 수 있습니다(예: 동영상을 연장할 때 참조 이미지 첨부).

**video\_list** `object[]`

입력 동영상, 최대 `3`개. 각 항목에 `video_url`이 필요합니다. 예: `{ "video_url": "https://example.com/input.mp4" }`. HTTPS URL, data URI, 플랫폼 업로드 동영상 URL을 지원하며 다운로드되는 입력 동영상은 개당 최대 50 MB, MP4/MOV입니다. `image_urls`와 함께 사용할 수 있어 동영상과 참조 이미지의 혼합 입력을 지원합니다. `edit` 및 `extend` 태스크에는 필수입니다.

**metadata** `object`

선택적 Interactions 생성 파라미터. `temperature`(`0.0`–`2.0`), `topP` / `top_p`(`0.0`–`1.0`), `candidateCount` / `candidate_count`, `previous_interaction_id`, `task`(`text_to_video`, `image_to_video`, `reference_to_video`, `edit`, `extend`)를 지원합니다. `task`를 생략하면 플랫폼이 기본값을 넣지 않고 업스트림 모델이 프롬프트와 미디어로 추론합니다. `edit`와 `extend`(또는 입력 동영상이 있고 다른 태스크 미지정) 경로에서는 `aspect_ratio`를 생략합니다. `extend`는 `video_list`로 입력한 원본 동영상을 이어서 촬영하며 `previous_interaction_id`와 함께 사용할 수 없습니다.

`generateAudio`, `negativePrompt`, `seed` 등 Veo 전용 파라미터는 지원하지 않습니다.

## Response

**id** `string`

상태 조회에 사용하는 태스크 ID.

**object** `string`

객체 유형. 일반적으로 `generation.task`입니다.

**model** `string`

사용된 모델 이름.

**status** `string`

태스크 상태: `queued`, `in_progress`, `completed`, `failed`.

**created\_at** `integer`

태스크 생성 타임스탬프.

**video\_url** `string`

태스크 완료 후 생성된 동영상 URL.

## Examples

```bash cURL theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-1.1-flash-preview-official",
    "prompt": "A red paper boat floating on a calm lake at sunrise",
    "duration": 3,
    "aspect_ratio": "16:9",
    "resolution": "360p"
  }'
```

동영상 편집 예시:

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-1.1-flash-preview-official",
    "prompt": "Change the sky to a warm sunset",
    "duration": 6,
    "resolution": "1080p",
    "video_list": [{"video_url": "https://example.com/uploaded-video.mp4"}],
    "metadata": {"task": "edit"}
  }'
```

동영상 연장 예시(`duration`은 연장 길이(초)이며 생략 시 약 10초. 출력은 원본에 연장분을 이어붙인 영상입니다):

```bash theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-omni-1.1-flash-preview-official",
    "prompt": "Continue the scene: the subject keeps moving naturally",
    "duration": 5,
    "video_list": [{"video_url": "https://example.com/uploaded-video.mp4"}],
    "metadata": {"task": "extend"}
  }'
```

```json 200 theme={null}
{
  "id": "video_01JZEXAMPLE",
  "object": "generation.task",
  "model": "gemini-omni-1.1-flash-preview-official",
  "status": "queued",
  "created_at": 1779247407
}
```

## 태스크 조회

제출 응답은 태스크 ID를 반환합니다. 공용 동영상 태스크 조회 엔드포인트로 상태와 결과를 가져오세요:

```bash theme={null}
curl --request GET \
  --url https://toapis.com/v1/videos/generations/{task_id} \
  --header "Authorization: Bearer YOUR_API_KEY"
```


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