> ## 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는 `POST /v1/videos/generations`를 통해 6가지 동영상 작업을 제공합니다. - **텍스트 기반 생성:** `gemini-omni-1.2-flash-text-to-video`. 텍스트 프롬프트만 필요하며 길이는 `3~15`초입니다. - **이미지 기반 생성:** `gemini-omni-1.2-flash-image-to-video`. 첫 프레임 1장은 `3~15`초, 첫·마지막 프레임 2장은 `3~10`초입니다. - **참조 자료 기반 생성:** `gemini-omni-1.2-flash-reference-to-video`. 참조 이미지와 최대 3개의 참조 동영상을 지원합니다. `duration`이 10초를 초과하면 참조 동영상은 최대 1개입니다. - **동영상 편집:** `gemini-omni-1.2-flash-video-edit`. 최대 15초의 동영상 1개가 필요하며 참조 이미지 최대 10장을 추가할 수 있습니다. `quality` 기본값은 `auto`입니다. - **동영상 확장:** `gemini-omni-1.2-flash-video-extend`. 최대 30초의 동영상 1개가 필요하며 참조 이미지 최대 10장을 추가할 수 있습니다. `quality` 기본값은 `auto`이고 `duration`은 추가할 초 수입니다. - **동영상 업스케일링:** `gemini-omni-1.2-flash-video-upscale`. 지원되는 표준 크기의 최대 15초 동영상 1개가 필요합니다. `quality`로 목표 해상도를 지정하며 프롬프트는 필요하지 않습니다. - **화면 비율:** 기본값은 `auto`입니다. 편집·확장·업스케일링은 입력 동영상의 비율을 유지합니다. - 동기화된 네이티브 오디오를 자동 생성하며 별도의 설정이 필요하지 않습니다. - `seed`를 고정하면 재현성을 높일 수 있습니다. - 비동기 처리이므로 작업 ID로 [상태를 조회](/ko/api-manual/task-management/get-task-detail)하세요. - 링크는 24시간 동안 유효하므로 빠르게 저장하세요. ## OpenAPI ````yaml ko/api-manual/video-series/gemini-omni-1.2-flash/gemini-omni-1.2-flash-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Gemini Omni 1.2 Flash 전체 파라미터 개요 description: >- Gemini Omni 1.2 Flash 전체 매개변수 개요입니다. 텍스트·이미지·참조 자료 기반 동영상 생성, 동영상 편집, 동영상 확장, 동영상 업스케일링의 6가지 모드를 다룹니다. 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 전체 파라미터 개요 description: >- - Gemini Omni 1.2 Flash는 `POST /v1/videos/generations`를 통해 6가지 동영상 작업을 제공합니다. - **텍스트 기반 생성:** `gemini-omni-1.2-flash-text-to-video`. 텍스트 프롬프트만 필요하며 길이는 `3~15`초입니다. - **이미지 기반 생성:** `gemini-omni-1.2-flash-image-to-video`. 첫 프레임 1장은 `3~15`초, 첫·마지막 프레임 2장은 `3~10`초입니다. - **참조 자료 기반 생성:** `gemini-omni-1.2-flash-reference-to-video`. 참조 이미지와 최대 3개의 참조 동영상을 지원합니다. `duration`이 10초를 초과하면 참조 동영상은 최대 1개입니다. - **동영상 편집:** `gemini-omni-1.2-flash-video-edit`. 최대 15초의 동영상 1개가 필요하며 참조 이미지 최대 10장을 추가할 수 있습니다. `quality` 기본값은 `auto`입니다. - **동영상 확장:** `gemini-omni-1.2-flash-video-extend`. 최대 30초의 동영상 1개가 필요하며 참조 이미지 최대 10장을 추가할 수 있습니다. `quality` 기본값은 `auto`이고 `duration`은 추가할 초 수입니다. - **동영상 업스케일링:** `gemini-omni-1.2-flash-video-upscale`. 지원되는 표준 크기의 최대 15초 동영상 1개가 필요합니다. `quality`로 목표 해상도를 지정하며 프롬프트는 필요하지 않습니다. - **화면 비율:** 기본값은 `auto`입니다. 편집·확장·업스케일링은 입력 동영상의 비율을 유지합니다. - 동기화된 네이티브 오디오를 자동 생성하며 별도의 설정이 필요하지 않습니다. - `seed`를 고정하면 재현성을 높일 수 있습니다. - 비동기 처리이므로 작업 ID로 [상태를 조회](/ko/api-manual/task-management/get-task-detail)하세요. - 링크는 24시간 동안 유효하므로 빠르게 저장하세요. operationId: createGeminiOmni12FlashGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GeminiOmni12FlashRequest' examples: text_to_video: summary: 텍스트-투-비디오 value: model: gemini-omni-1.2-flash-text-to-video prompt: 유리 구슬이 나무 트랙을 빠르게 굴러간 뒤 물에 떨어져 물보라를 일으킨다. quality: 720p duration: 3 aspect_ratio: '16:9' image_to_video: summary: 첫 프레임과 마지막 프레임으로 비디오 생성 value: model: gemini-omni-1.2-flash-image-to-video prompt: 일출 장면에서 밤의 불빛으로 부드럽게 전환한다. image_urls: - https://example.com/first-frame.png - https://example.com/last-frame.png quality: 720p duration: 3 aspect_ratio: '16:9' reference_to_video: summary: 레퍼런스-투-비디오 value: model: gemini-omni-1.2-flash-reference-to-video prompt: 참조 이미지 속 인물의 외모를 유지하고 참조 동영상의 카메라 움직임을 따른다. image_urls: - https://example.com/character.png video_urls: - https://example.com/reference.mp4 quality: 720p duration: 3 aspect_ratio: '16:9' video_edit: summary: 비디오 편집 value: model: gemini-omni-1.2-flash-video-edit prompt: 전체 조명을 따뜻한 일몰 분위기로 바꾸고 나머지는 그대로 유지한다. video_urls: - https://example.com/source.mp4 quality: auto duration: auto aspect_ratio: auto video_extend: summary: 비디오 연장 value: model: gemini-omni-1.2-flash-video-extend prompt: 인물이 계속 앞으로 걸어가며 천천히 화면 밖으로 나간다. video_urls: - https://example.com/source.mp4 duration: 3 quality: auto aspect_ratio: auto 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-text-to-video 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: GeminiOmni12FlashRequest: type: object required: - model additionalProperties: false properties: model: type: string description: >- 모델 이름입니다. 입력 자료와 작업 유형에 맞는 모델 ID를 선택하세요. - `gemini-omni-1.2-flash-text-to-video`: 텍스트 기반 동영상 생성 - `gemini-omni-1.2-flash-image-to-video`: 이미지 기반 동영상 생성(첫 프레임 또는 첫·마지막 프레임) - `gemini-omni-1.2-flash-reference-to-video`: 참조 자료 기반 동영상 생성 - `gemini-omni-1.2-flash-video-edit`: 동영상 편집 - `gemini-omni-1.2-flash-video-extend`: 동영상 확장 - `gemini-omni-1.2-flash-video-upscale`: 동영상 업스케일링 enum: - gemini-omni-1.2-flash-text-to-video - gemini-omni-1.2-flash-image-to-video - gemini-omni-1.2-flash-reference-to-video - gemini-omni-1.2-flash-video-edit - gemini-omni-1.2-flash-video-extend - gemini-omni-1.2-flash-video-upscale example: gemini-omni-1.2-flash-text-to-video prompt: type: string description: >- 생성·편집·이어 만들기 목표를 설명하는 텍스트 프롬프트로 중국어와 영어를 지원합니다. 업스케일링을 제외한 모든 모드에서 필수이며 업스케일링은 프롬프트가 필요하지 않습니다. - 대상, 동작, 장면, 카메라 움직임, 유지할 내용을 명확하게 설명하세요. - 부정 지시를 직접 작성하세요(예: `No dialogue`, `텍스트 표시 금지`). 별도의 네거티브 프롬프트 매개변수는 없습니다. 동영상 업스케일링은 `prompt`를 사용하지 않으며, 전달된 프롬프트는 무시됩니다. example: 유리 구슬이 나무 트랙을 빠르게 굴러간 뒤 물에 떨어져 물보라를 일으킨다. image_urls: type: array items: type: string format: uri minItems: 1 maxItems: 10 description: |- 입력 이미지 배열입니다. - 이미지 기반 생성: 필수, 1~2장. 1장은 첫 프레임, 2장은 첫·마지막 프레임입니다. - 참조 자료 기반 생성: 필수이며 공개 권장 상한은 참조 이미지 10장입니다. - 동영상 편집: 선택 사항, 참조 이미지 최대 10장. - 동영상 확장: 선택 사항, 참조 이미지 최대 10장. - 텍스트 기반 생성 및 업스케일링: 이미지 입력을 지원하지 않습니다. HTTP/HTTPS 이미지 URL만 지원합니다. 형식: `png`, `jpeg`, `webp`. example: - https://example.com/character.png - https://example.com/scene.png video_urls: type: array items: type: string format: uri minItems: 1 maxItems: 3 description: >- 입력 동영상 배열입니다. - 참조 자료 기반 생성: 선택 사항이며 공개 권장 상한은 3개입니다. `duration`이 10초를 초과하면 최대 1개입니다. - 동영상 편집: 정확히 1개 필수, 최대 15초. - 동영상 확장: 정확히 1개 필수, 최대 30초. - 업스케일링: 정확히 1개 필수, 최대 15초. `640×360`, `1280×720`, `1920×1080` 및 이에 대응하는 세로 크기만 지원합니다. - 텍스트·이미지 기반 생성: 동영상 입력을 지원하지 않습니다. 각 참조 동영상의 길이는 `10`초 이하여야 합니다. example: - https://example.com/reference.mp4 quality: type: string description: >- 동영상 해상도입니다. **선택값(가로 / 세로):** - `360p`: 640×360 / 360×640 - `720p`: 1280×720 / 720×1280 - `1080p`: 1920×1080 / 1080×1920 - `4k`: 3840×2160 / 2160×3840 - `auto`: 편집과 확장만 지원하며 입력 해상도를 따릅니다. **기본값:** - 텍스트·이미지·참조 자료 기반 생성: `720p`. - 동영상 편집·확장: `auto`. - 업스케일링: 입력보다 높은 목표 해상도를 반드시 지정해야 합니다. 360p → `720p` 또는 `1080p`, 720p → `1080p` 또는 `4k`, 1080p → `4k`. **과금 안내:** 텍스트·이미지·참조 기반 동영상 생성, 편집 및 확장은 입력 토큰, 동영상 출력 토큰, 기타 출력 토큰(사고 토큰 포함)에 대해 각각 과금됩니다. 동영상 업스케일링은 동영상 출력 토큰에 대해서만 과금되며 입력 토큰이나 사고 토큰 요금은 부과되지 않습니다. 요청 제출 시 요금은 예상 금액이며, 최종 요금은 실제 사용량에 따라 정산됩니다. enum: - 360p - 720p - 1080p - 4k - auto example: 720p duration: description: |- 동영상 길이입니다. - 텍스트·참조 자료 기반 생성: `3`~`15`초 정수, 기본값 `3`. - 이미지 기반 생성: 첫 프레임 1장은 `3`~`15`초, 첫·마지막 프레임 2장은 `3`~`10`초, 기본값 `3`. - 동영상 편집·업스케일링: `auto`만 허용하며 기본값도 `auto`입니다. 출력 길이는 입력을 따릅니다. - 동영상 확장: `3`~`10`초 정수, 기본값 `3`. 추가할 길이를 의미합니다. oneOf: - type: integer minimum: 3 maximum: 15 - type: string enum: - auto example: 3 aspect_ratio: type: string description: |- 동영상 화면 비율이며 기본값은 `auto`입니다. - `16:9`: 가로. - `9:16`: 세로. - `auto`: 프롬프트와 입력 자료에 따라 모델이 결정하는 기본값입니다. 편집·확장·업스케일링은 `auto`만 허용하며 입력 동영상의 비율을 유지합니다. enum: - '16:9' - '9:16' - 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 allOf: - if: properties: model: const: gemini-omni-1.2-flash-text-to-video required: - model then: properties: duration: type: integer default: 3 minimum: 3 maximum: 15 quality: enum: - 360p - 720p - 1080p - 4k default: 720p prompt: minLength: 1 pattern: \S not: anyOf: - required: - image_urls - required: - video_urls required: - prompt - if: properties: model: const: gemini-omni-1.2-flash-image-to-video required: - model then: required: - prompt - image_urls properties: image_urls: maxItems: 2 duration: type: integer default: 3 minimum: 3 maximum: 15 quality: enum: - 360p - 720p - 1080p - 4k default: 720p prompt: minLength: 1 pattern: \S not: anyOf: - required: - video_urls allOf: - if: properties: image_urls: minItems: 2 required: - image_urls then: properties: duration: maximum: 10 - if: properties: model: const: gemini-omni-1.2-flash-reference-to-video required: - model then: required: - prompt - image_urls properties: video_urls: maxItems: 3 duration: type: integer default: 3 minimum: 3 maximum: 15 quality: enum: - 360p - 720p - 1080p - 4k default: 720p prompt: minLength: 1 pattern: \S allOf: - if: properties: duration: type: integer minimum: 11 required: - duration then: properties: video_urls: maxItems: 1 - if: properties: model: const: gemini-omni-1.2-flash-video-edit required: - model then: required: - prompt - video_urls properties: video_urls: maxItems: 1 image_urls: maxItems: 10 duration: type: string enum: - auto default: auto aspect_ratio: enum: - auto quality: enum: - 360p - 720p - 1080p - 4k - auto default: auto prompt: minLength: 1 pattern: \S - if: properties: model: const: gemini-omni-1.2-flash-video-extend required: - model then: required: - prompt - video_urls properties: video_urls: maxItems: 1 image_urls: maxItems: 10 duration: type: integer default: 3 minimum: 3 maximum: 10 aspect_ratio: enum: - auto quality: enum: - 360p - 720p - 1080p - 4k - auto default: auto prompt: minLength: 1 pattern: \S - if: properties: model: const: gemini-omni-1.2-flash-video-upscale required: - model then: required: - video_urls - quality properties: video_urls: maxItems: 1 quality: enum: - 720p - 1080p - 4k duration: type: string enum: - auto default: auto aspect_ratio: enum: - auto default: auto not: required: - image_urls 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-text-to-video 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: >- 출력 동영상 길이(초)입니다. - 텍스트·이미지·참조 자료 기반 생성: 요청의 `duration`과 같습니다. - 동영상 편집: `duration`은 기본값인 `auto`만 허용합니다. 출력은 입력을 따르며 이 필드는 시스템이 감지한 입력 길이를 반환합니다. - 동영상 확장: 입력 길이에 요청한 추가 `duration`을 더한 전체 출력 길이입니다. - 업스케일링: 입력과 같으며 감지된 입력 길이를 반환합니다. example: 3 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.