Gemini Omni 1.2 Flash

2026-11-07 확인한 APIMaster gemini-omni-1.2-flash 게이트웨이 사양입니다. Google Interactions 기본 API가 아니며 1.1 Official/Ext 사양은 적용되지 않습니다.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

엔드포인트와 인증

공개 경로는 채널 335입니다. Authorization: Bearer YOUR_API_KEY 및 Content-Type: application/json을 사용합니다. 일반 모델·그룹 권한, 잔액, 경로 가용성이 적용되며 추가 고객 허용 목록은 공개되지 않았습니다. 모델 ID에 채널 번호를 붙이지 마세요. 1.2 전용 Ext 경로는 없습니다. 모델 목록에 있다고 Google의 모든 기능을 제공하는 것은 아닙니다.

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key
• GET https://apimaster.ai/api/log/token

매개변수와 제한

필드	유형	규칙
model	string	정확한 공개 모델 ID.
prompt	string	편집·연장을 포함한 모든 모드에서 공백이 아닌 지시가 필수. 생성할 음성도 여기 설명합니다.
duration	integer	기본 10. 일반 생성은 정수 3–15초, 첫/마지막 프레임 보간과 연장 새 구간은 3–10초. 편집에서는 무시.
seconds	integer / string	duration 호환 별칭. 정수 또는 정수 문자열. 동시 지정 시 duration 우선.
resolution	string	360p, 720p(기본), 1080p, 4k. 대소문자 무관. 2160p는 4k로 변환. 1080p/4k는 업스케일.
aspect_ratio	string	16:9(기본) 또는 9:16. 다른 문자열은 현재 16:9로 정규화.
ratio	string	이전 화면 비율 별칭이며 해상도가 아님. aspect_ratio 권장.
size	string	화면 비율 별칭. 우선순위 aspect_ratio, ratio, size.
image_urls	string[]	공개 HTTP(S) 이미지 URL 배열. 보통 한 장은 시작 이미지, 여러 장은 참조.
first_frame_image	string	첫 프레임의 공개 URL.
last_frame_image	string	first_frame_image 필수. 프레임 비율은 출력과 일치시킵니다.
image_with_roles	object[]	명시적 프레임 필드와 함께 사용 불가. 각 항목 url 및 비어 있지 않은 role. first_frame/last_frame 외에는 참조. 마지막에는 첫 프레임 필요.
video_urls	string[]	최대 1개, 15초 이하 공개 입력 영상. 기본 편집.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. 연장은 extend 명시 필요.
extend_from_task_id	string	동일 계정·모델의 완료된 공개 작업 ID. video_urls와 배타적. 원래 채널·계정 사용 가능해야 함. Google interaction ID가 아님.

이미지와 프레임은 합계 10개까지. image_with_roles와 명시적 프레임 필드는 양자택일입니다. 상위 공급자는 인물 최대 2명, 인물당 이미지 3개를 권장합니다. 직접 접근 가능한 공개 HTTP(S) URL만 허용하며 Base64, Data URL, multipart는 미지원. PNG/JPEG 및 MP4 검증 완료. 길이 검사는 MP4/MOV 호환 미디어를 최대 100 MiB 읽지만 공급자가 보장하는 업로드 크기 한도는 아닙니다. 이미지당 한도와 전체 코덱·크기 사양은 확정되지 않았습니다.

음성 참조, audio_urls, Google interaction/conversation 상태, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps, n 미지원. 부정 지시와 생성 음성은 prompt에 작성합니다. 완료 공개 작업을 연결할 수 있으나 매번 입력 영상은 15초 이하여야 하며 Google 기본 다중 턴 대화는 아닙니다. 알 수 없는 최상위 필드는 거부합니다.

실행하지 않는 JSON 예제

다음은 실행하지 않는 JSON 본문입니다. example.com과 작업 ID를 교체하세요. 새 작업에는 새 키를, 재시도에는 동일 키·본문을 사용합니다. 다음 연장은 완료된 하위 작업의 공개 ID를 사용합니다. 유효한 음성 입력 예제는 없습니다.

1. text_to_video

{"model":"gemini-omni-1.2-flash","prompt":"A blue glass sphere rolls slowly across a plain gray table.","duration":3,"resolution":"360p","aspect_ratio":"16:9"}

2. reference_to_video

{"model":"gemini-omni-1.2-flash","prompt":"Animate these geometric references while preserving their shapes and colors.","image_urls":["https://example.com/reference-a.png","https://example.com/reference-b.png"],"omni_reference_task_type":"reference","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

3. first_frame_image / last_frame_image

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition from the first view to the last view.","first_frame_image":"https://example.com/first.png","last_frame_image":"https://example.com/last.png","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

4. image_with_roles

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition between these views.","image_with_roles":[{"url":"https://example.com/first.png","role":"first_frame"},{"url":"https://example.com/last.png","role":"last_frame"}],"duration":6,"resolution":"720p"}

5. edit / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Change the lighting to sunset while preserving the scene.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"edit","resolution":"720p"}

6. extend / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Continue the camera movement for three more seconds.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

7. extend / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Continue the previous scene with a gentle camera pan.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

8. edit / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Keep the scene but turn the blue sphere yellow.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"edit","resolution":"720p"}

작업 조회와 다운로드

최초 접수 POST는 HTTP 200, queued를 반환합니다. 5–10초마다 조회하며 queued → in_progress → completed/failed와 일시적 unknown을 처리하세요. url 및 metadata.url은 인증 프록시이며 다운로드에도 Bearer가 필요합니다. 생성 실패는 보통 HTTP 200 및 error.code=generation_failed와 정제된 메시지로 반환합니다. 제출 오류는 4xx/5xx입니다. 시간 초과·5xx는 미접수 증거가 아닙니다. 아래 예제는 ID와 시간을 대체했습니다.

{"id":"task_REDACTED_EXAMPLE","task_id":"task_REDACTED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"queued"}

{"id":"task_REDACTED_COMPLETED_EXAMPLE","task_id":"task_REDACTED_COMPLETED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"completed","progress":100,"created_at":1793966808,"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content","metadata":{"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content"}}

{"id":"task_REDACTED_FAILED_EXAMPLE","task_id":"task_REDACTED_FAILED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"failed","progress":100,"created_at":1793966808,"error":{"code":"generation_failed","message":"The generation request failed."}}

사용량·최종 비용·환불

작업 조회에 usage·모달리티 내역·USD가 보장되지 않습니다. 정산 후 최종 고객 비용은 소비 로그의 other.final_amount_usd입니다. GET /api/log/token은 같은 키의 제한된 최근 기록이며 전체 청구서 보관함이 아닙니다. GET /api/log/self는 계정 인증이 필요합니다. other를 JSON으로 파싱해 other.task_id로 찾으세요. 실제 사용량에는 prompt_tokens, completion_tokens 및 other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices, group_ratio가 있을 수 있습니다. 입력은 합계이며 텍스트·이미지·영상별 세부 수치는 보장하지 않습니다.

2026-11-07 채널 335 기본 판매가는 백만 토큰당 입력 $1.32, 텍스트 출력 $7.92, 영상 출력 $10.56으로 계정 배율 적용 전입니다. 현재 모델 카드를 확인하세요. 추정액을 예약하고 고정 단가·실제 사용량으로 추가 청구 또는 환불합니다. 확인된 생성 실패는 예약 환불, 접수 불명은 즉시 환불 보장 없음. 500,000 quota = USD 1. 예약은 최종 청구가 아니며 최종액과 조정 기록을 중복 합산하지 마세요. 과거 검증은 입력 39, 텍스트 0, 영상 5793, $0.064286이며 새 요청 고정 견적이 아닙니다.

USD = (input_tokens × input_rate
     + text_output_tokens × text_output_rate
     + video_output_tokens × video_output_rate) / 1,000,000

연장은 새 구간의 영상 출력과 참조 영상 입력을 청구합니다. 합쳐진 전체 파일을 새 출력으로 청구하지 않습니다. 검증한 3초+3초 연장은 약 6초 파일, 새 출력 약 3초입니다. 생성 음성은 영상 출력에 포함됩니다. 텍스트 세부 내역이 없으면 현재 파서는 보고된 출력을 영상으로 처리합니다. 유효 토큰 없이 신뢰할 수 있는 공급자 비용 영수증이 있으면 token_usage_source=provider_cost_receipt로 정산하며 토큰을 지어내지 않습니다. 둘 다 없으면 정산을 계속 대기합니다. 모든 세부 수치와 고정 정산 시간은 보장하지 않습니다.

게이트웨이 멱등성과 복구

Idempotency-Key는 공백 없는 표시 가능한 ASCII 8–128자, 계정 범위이며 본문 필드는 없습니다. 동일 키·요청 재전송은 HTTP 202 및 Idempotency-Replayed:true로 반환하고 재생성·이중 예약하지 않습니다. 본문·그룹·명시 경로 변경은 409 idempotency_conflict. JSON 키 순서는 무시하나 배열 순서와 생략/명시 기본값 차이는 중요합니다. 연결이 끊겨도 게이트웨이는 제한 시간 내 원래 제출과 저장을 마치려고 합니다.

{"code":200,"data":{"submission_id":"REDACTED_SUBMISSION_ID","task_id":"task_REDACTED_EXAMPLE","model":"gemini-omni-1.2-flash","status":"accepted","task_ready":true,"same_key_replay_safe":true,"new_submission_safe":false,"next_action":"query_task"}}

GET /v1/video-submissions/by-key에 원래 키와 Bearer를 보내면 영수증만 읽고 생성·공급자 검색·자금 변경은 하지 않습니다. pending/submitting은 조회 지속, accepted 및 task_ready=true는 task_id 조회, 준비 안 됨은 정산·지원 대기. acceptance_unknown은 자동 재전송 없이 키와 참조 보존. not_accepted는 확정 오류를 수정하고 영수증·자금 상태가 허용할 때만 새 키 사용. 이전 키는 기존 결과를 재생합니다. 404 및 retry_safe=false는 미접수 증거가 아닙니다. 최소 30일 유지하며 자동 재사용하지 않습니다. 키 없는 반복 POST는 새 작업입니다. Google/APIMart 기본 기능이 아닌 게이트웨이 멱등성이며 불명 제출은 재전송하지 않습니다. 접수·자금 확정 기록은 재생성·재청구 없이 복구할 수 있습니다.

미지원 기능과 견적

POST /v1/videos/quote는 이 모델 미지원으로 현재 Seedance 전용입니다. Omni의 무료·작업 미생성·상위 생성기 미호출 견적 계약 및 전용 invoice 또는 /v1/videos/{task_id}/billing 최종 청구 계약은 없습니다. 공급자 검열·지역 제한이 적용되며 EEA·스위스·영국에는 업로드 영상 편집·연장 제한이 있습니다. 연결된 스키마는 게이트웨이 사양이며 공급자 기본 예제는 APIMaster ID·응답·로그를 대체하지 않습니다.

APIMart · Gemini Omni 1.2 Flash