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

# Gemini Omni 1.2 Flash 동영상 업스케일링

> - Gemini Omni 1.2 Flash(`gemini-omni-1.2-flash-video-upscale`)는 원본 영상 내용과 오디오를 유지하면서 해상도를 높입니다. 프롬프트는 필요하지 않습니다.
- **동영상:** `video_urls`는 최대 15초 동영상 1개가 필수입니다.
- **입력 크기:** 16:9 또는 9:16의 표준 크기만 지원합니다. `640×360`, `1280×720`, `1920×1080`, 또는 세로 `360×640`, `720×1280`, `1080×1920`입니다.
- **목표 해상도:** `quality`는 필수입니다. 360p → `720p` 또는 `1080p`, 720p → `1080p` 또는 `4k`, 1080p → `4k`입니다.
- **출력:** 길이, 화면 비율, 오디오는 입력을 따르며 프레임 속도는 24 fps입니다.
- `seed`를 고정하면 재현성을 높일 수 있습니다.
- 비동기 처리이므로 작업 ID로 [상태를 조회](/ko/api-manual/task-management/get-task-detail)하세요.
- 링크는 24시간 동안 유효하므로 빠르게 저장하세요.

동영상 업스케일링은 `prompt`를 사용하지 않으며, 전달된 프롬프트는 무시됩니다.



## OpenAPI

````yaml ko/api-manual/video-series/gemini-omni-1.2-flash/gemini-omni-1.2-flash-video-upscale.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: gemini-omni-1.2-flash-video-upscale API
  description: Gemini Omni 1.2 Flash로 원본 영상 내용과 오디오를 유지하면서 입력 동영상의 해상도를 높입니다.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: 프로덕션 환경
security:
  - bearerAuth: []
paths:
  /v1/videos/generations:
    post:
      tags:
        - 비디오 생성
      summary: gemini-omni-1.2-flash-video-upscale API
      description: >-
        - Gemini Omni 1.2 Flash(`gemini-omni-1.2-flash-video-upscale`)는 원본 영상
        내용과 오디오를 유지하면서 해상도를 높입니다. 프롬프트는 필요하지 않습니다.

        - **동영상:** `video_urls`는 최대 15초 동영상 1개가 필수입니다.

        - **입력 크기:** 16:9 또는 9:16의 표준 크기만 지원합니다. `640×360`, `1280×720`,
        `1920×1080`, 또는 세로 `360×640`, `720×1280`, `1080×1920`입니다.

        - **목표 해상도:** `quality`는 필수입니다. 360p → `720p` 또는 `1080p`, 720p → `1080p`
        또는 `4k`, 1080p → `4k`입니다.

        - **출력:** 길이, 화면 비율, 오디오는 입력을 따르며 프레임 속도는 24 fps입니다.

        - `seed`를 고정하면 재현성을 높일 수 있습니다.

        - 비동기 처리이므로 작업 ID로 [상태를
        조회](/ko/api-manual/task-management/get-task-detail)하세요.

        - 링크는 24시간 동안 유효하므로 빠르게 저장하세요.


        동영상 업스케일링은 `prompt`를 사용하지 않으며, 전달된 프롬프트는 무시됩니다.
      operationId: createGeminiOmni12FlashVideoUpscaleGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GeminiOmni12FlashVideoUpscaleRequest'
            examples:
              video_upscale:
                summary: 동영상 업스케일링
                value:
                  model: gemini-omni-1.2-flash-video-upscale
                  video_urls:
                    - https://example.com/source-720p.mp4
                  quality: 1080p
      responses:
        '200':
          description: 영상 작업 생성 성공
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: 요청 매개변수 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: 인증 실패, Token이 유효하지 않거나 만료됨
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: 할당량 부족, 충전 필요
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: insufficient_quota
                  message: Insufficient quota. Please top up your account.
                  type: insufficient_quota
        '403':
          description: 접근 권한 없음
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: >-
                    Token does not have access to model:
                    gemini-omni-1.2-flash-video-upscale
                  type: invalid_request_error
        '429':
          description: 요청 빈도 초과
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Too many requests, please try again later
                  type: rate_limit_error
        '500':
          description: 서버 내부 오류
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Internal server error
                  type: api_error
components:
  schemas:
    GeminiOmni12FlashVideoUpscaleRequest:
      required:
        - model
        - video_urls
        - quality
      type: object
      additionalProperties: false
      properties:
        model:
          type: string
          description: 모델 이름은 `gemini-omni-1.2-flash-video-upscale`으로 고정됩니다.
          enum:
            - gemini-omni-1.2-flash-video-upscale
          example: gemini-omni-1.2-flash-video-upscale
          default: gemini-omni-1.2-flash-video-upscale
        video_urls:
          type: array
          items:
            type: string
            format: uri
          minItems: 1
          maxItems: 1
          description: >-
            업스케일링할 동영상 배열이며 정확히 1개가 필수입니다. HTTP/HTTPS URL, mp4 형식, 최대 `15`초를
            지원합니다. 크기는 `640×360`, `1280×720`, `1920×1080`, 또는 세로 `360×640`,
            `720×1280`, `1080×1920`만 허용합니다.
          example:
            - https://example.com/source-720p.mp4
        quality:
          type: string
          description: >-
            목표 해상도로, 필수이며 입력 해상도보다 높아야 합니다.


            - 입력 360p: `720p`, `1080p`.

            - 입력 720p: `1080p`, `4k`.

            - 입력 1080p: `4k`.


            **과금 안내:** 실제 동영상 출력 토큰 사용량에 따라 정산되며 입력 토큰이나 사고 토큰 요금은 부과되지 않습니다. 출력
            토큰 사용량은 입력 동영상의 길이와 입력·목표 해상도 조합에 따라 달라집니다. 요청 제출 시 요금은 예상 금액이며, 최종
            요금은 실제 사용량에 따라 정산됩니다.
          enum:
            - 720p
            - 1080p
            - 4k
          example: 1080p
        duration:
          type: string
          description: >-
            생략할 수 있으며, 지정할 경우 `auto`만 지원합니다. 출력 길이는 입력 동영상을 따르며 초 단위 길이를 지정할 수
            없습니다.
          enum:
            - auto
          default: auto
          example: auto
        aspect_ratio:
          type: string
          description: >-
            생략할 수 있으며, 지정할 경우 `auto`만 지원합니다. 출력 화면 비율은 입력 동영상을 따르며 다른 비율을 지정할 수
            없습니다.
          enum:
            - auto
          default: auto
          example: auto
        seed:
          type: integer
          description: >-
            난수 시드이며 기본적으로 무작위로 선택됩니다. 범위는 `0`~`4294967295`입니다. 고정하면 재현성을 높일 수
            있습니다.
          minimum: 0
          maximum: 4294967295
          example: 42
        callback_url:
          type: string
          description: >-
            작업 완료 후 HTTPS 콜백 주소


            **콜백 타이밍:**

            - 작업이 완료(completed), 실패(failed) 또는 취소(cancelled)될 때 트리거됨

            - 과금 확인 완료 후 전송


            **보안 제한:**

            - HTTPS 프로토콜만 지원

            - 내부 IP 주소로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x
            등)

            - URL 길이는 `2048`자를 초과할 수 없음


            **콜백 메커니즘:**

            - 타임아웃: `10`초

            - 실패 시 최대 `3`회 재시도 (실패 후 각각 `1`초/`2`초/`4`초 후 재시도)

            - 콜백 응답 본문 형식은 작업 조회 API 응답 형식과 동일

            - 콜백 주소가 2xx 상태 코드를 반환하면 성공으로 간주, 다른 상태 코드는 재시도를 트리거
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: 작업 생성 타임스탬프
          example: 1757169743
        id:
          type: string
          description: 작업 ID
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: 실제 사용된 모델 이름
          example: gemini-omni-1.2-flash-video-upscale
        object:
          type: string
          enum:
            - video.generation.task
          description: 특정 작업 유형
        progress:
          type: integer
          description: 작업 진행률 (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: >-
            작업 상태입니다. 생성 API는 항상 `processing`을 반환하며 내부 `pending` 상태도 클라이언트에는
            `processing`으로 표시됩니다.
          enum:
            - pending
            - processing
            - completed
            - failed
          example: processing
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: 비디오 작업 상세 정보
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: 작업 출력 유형
          example: video
        usage:
          $ref: '#/components/schemas/Usage'
          description: 사용량 및 과금 정보
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: 오류 코드 식별자
            message:
              type: string
              description: 오류 설명
            type:
              type: string
              description: 오류 유형
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: 작업 취소 가능 여부
          example: false
        estimated_time:
          type: integer
          description: 예상 완료 시간 (초)
          minimum: 0
          example: 60
        video_duration:
          type: integer
          description: 출력 동영상 길이(초)로 입력과 같습니다. 시스템이 감지한 입력 동영상 길이를 반환합니다.
          example: 5
    Usage:
      type: object
      description: 사용량 및 과금 정보
      properties:
        billing_rule:
          type: string
          description: 과금 규칙
          enum:
            - per_call
            - per_token
            - per_second
          example: per_token
        credits_reserved:
          type: number
          description: 예상 소비 크레딧
          minimum: 0
          example: 102.34
        user_group:
          type: string
          description: 사용자가 속한 과금 그룹
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |-
        ##모든 API는 Bearer Token 인증이 필요합니다##

        **API Key 받기:**

        [API Key 관리 페이지](https://evolink.ai/dashboard/keys)를 방문하여 API Key를 받으세요

        **요청 헤더에 추가:**
        ```
        Authorization: Bearer YOUR_API_KEY
        ```

````

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