Gemini Omni 1.2 Flash

Contrato del gateway APIMaster para gemini-omni-1.2-flash, verificado el 2026-11-07. No es la API nativa Google Interactions; las reglas Official/Ext de 1.1 no se aplican.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

Rutas y autenticación

La ruta pública actual es el canal 335. Use Authorization: Bearer YOUR_API_KEY y Content-Type: application/json. Se mantienen los permisos de modelo/grupo, el saldo y la disponibilidad; no hay una lista adicional de clientes autorizados publicada. No añada el canal al ID. No existe una ruta Ext independiente de 1.2. Que aparezca en el listado no significa que exponga todas las funciones de 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

Parámetros y límites

Campo	Tipo	Regla
model	string	ID público exacto del modelo.
prompt	string	Instrucción no vacía obligatoria en todos los modos, incluida la edición y continuación.
duration	integer	Predeterminado 10; generación normal 3–15 segundos enteros; interpolación y segmento nuevo de extensión 3–10. Se ignora al editar.
seconds	integer / string	Alias compatible de duration, entero o cadena de entero; duration tiene prioridad si aparecen ambos.
resolution	string	360p, 720p (predeterminado), 1080p o 4k; sin distinción de mayúsculas. 2160p equivale a 4k. 1080p/4k son reescalados.
aspect_ratio	string	16:9 por defecto o 9:16; otras cadenas se normalizan actualmente a 16:9. Use solo los valores admitidos.
ratio	string	Alias antiguo de relación de aspecto, no de resolución. Prefiera aspect_ratio.
size	string	Alias antiguo; prioridad aspect_ratio, ratio, size.
image_urls	string[]	URLs públicas HTTP(S) de imágenes; una imagen inicia la escena por defecto, varias sirven de referencias.
first_frame_image	string	URL pública del primer fotograma.
last_frame_image	string	Requiere first_frame_image; las proporciones deben coincidir con la salida.
image_with_roles	object[]	Alternativa a los campos de fotogramas. Cada objeto contiene url y role no vacío: first_frame/last_frame son fotogramas; otros roles son referencias. El último requiere el primero.
video_urls	string[]	Como máximo un vídeo público de entrada de hasta 15 segundos; por defecto se edita.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. La extensión requiere extend explícito.
extend_from_task_id	string	ID público task_... de una tarea completada de su cuenta y de este modelo; excluye video_urls. Deben seguir disponibles el canal y la cuenta originales. No es un Google interaction ID.

El total de imágenes y fotogramas no puede superar 10. Elija image_with_roles o los campos explícitos, no ambos. El proveedor recomienda como máximo dos personajes y tres imágenes de cada uno. Solo URLs HTTP(S) públicas y directas: no Base64, Data URL ni multipart. Se han validado PNG/JPEG y MP4. La inspección de duración admite medios compatibles con MP4/MOV y lee hasta 100 MiB; no es un límite de carga garantizado por el proveedor. No se ha publicado un límite por imagen ni un contrato exhaustivo de códecs y tamaños.

No se admiten referencias de audio, audio_urls, estado de Google interaction/conversation, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps ni n. Escriba las restricciones negativas y el audio deseado en prompt. Puede encadenar tareas públicas completadas, pero cada vídeo de entrada sigue limitado a 15 segundos; no es una conversación nativa de Google. Se rechazan campos superiores desconocidos.

Ejemplos JSON sin ejecución

Son cuerpos JSON inertes, no scripts. Sustituya example.com y los IDs de ejemplo. Cada nueva operación usa una clave nueva; para reintentar conserve clave y cuerpo. En el siguiente turno use el ID público de la tarea hija completada. No existe ejemplo válido de audio de entrada.

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"}

Tareas, consulta y descarga

El primer POST aceptado devuelve HTTP 200 y queued. Consulte cada 5–10 segundos: queued → in_progress → completed/failed; tolere también unknown transitorio. url y metadata.url son proxies autenticados: descargue con Bearer. El fallo de generación suele devolverse con HTTP 200 y error.code=generation_failed, con mensaje saneado; los errores de envío usan 4xx/5xx. Un timeout o 5xx no demuestra que no se aceptó. Los siguientes ejemplos sustituyen la identidad y fecha de la tarea.

{"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."}}

Uso, coste final y reembolsos

La consulta de tareas no garantiza usage, desglose de modalidades ni USD. El cargo final al cliente, tras conciliación, es other.final_amount_usd del registro de consumo. GET /api/log/token con la misma clave devuelve una lista reciente y limitada de esa clave, no un archivo de facturas. GET /api/log/self exige autenticación de cuenta para su historial; una clave de generación no la sustituye. Analice other como JSON y busque other.task_id. Con uso real pueden aparecer prompt_tokens, completion_tokens y other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices, group_ratio. La entrada es agregada, sin desglose garantizado de texto/imagen/vídeo.

A 2026-11-07, las tarifas base del canal 335 son $1.32 entrada, $7.92 texto y $10.56 vídeo por millón de tokens, antes de multiplicadores de cuenta; consulte la tarjeta actual. Se reserva una estimación y se concilia con uso real y precios congelados, con cobro adicional o devolución. Un fallo de generación confirmado devuelve la reserva; una aceptación desconocida no garantiza devolución inmediata. 500,000 quota = USD 1. La reserva inicial no es la factura final: no sume de nuevo el importe final con sus ajustes. Ejemplo histórico: entrada 39, texto 0, vídeo 5793, importe $0.064286; no es una cotización fija nueva.

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

La extensión cobra salida de vídeo del segmento nuevo más la entrada del vídeo de referencia, aunque el MP4 combine ambos. Se validó un original de 3 segundos extendido 3: archivo de unos 6 segundos, salida de unos 3 nuevos. El audio generado forma parte de la salida de vídeo. Sin detalle de texto, el parser actual considera la salida declarada como vídeo. Si faltan tokens válidos pero hay recibo de coste autoritativo, puede liquidarse desde ese recibo con token_usage_source=provider_cost_receipt, sin inventar contadores. Sin uso ni coste continúa la conciliación. No se garantizan contadores completos ni un plazo fijo de liquidación.

Idempotencia del gateway y recuperación

Idempotency-Key tiene 8–128 caracteres ASCII visibles sin espacios, sin equivalente en el cuerpo y con alcance por cuenta. Misma cuenta/clave/petición: HTTP 202 e Idempotency-Replayed:true, sin segunda generación ni reserva. Cambios de cuerpo, grupo o ruta explícita: 409 idempotency_conflict. Se ignora el orden de claves JSON; importan valores, orden de arrays y valores por defecto omitidos o explícitos. Tras desconexión, el gateway intenta terminar el envío original y persistencia dentro de su plazo acotado.

{"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 con clave original y Bearer solo lee el recibo: no genera, no busca por clave en el proveedor y no mueve fondos. pending/submitting: siga consultando; accepted con task_ready=true: consulte task_id; accepted no listo: espere conciliación o contacte soporte; acceptance_unknown: no reenvíe automáticamente, conserve clave y referencia; not_accepted: corrija el error confirmado y use una clave nueva solo si el recibo y los fondos lo permiten. La clave antigua sigue reproduciendo el resultado original. Un 404 con retry_safe=false no prueba no aceptación. Retención mínima 30 días, sin reutilización automática. Repetir un POST sin clave de cliente crea otra operación. Es idempotencia del gateway, no nativa de Google/APIMart; no se reenvían originales inciertos. Los registros aceptados y financieramente confirmados pueden restaurarse sin generar ni cobrar otra vez.

Funciones no disponibles y presupuestos

POST /v1/videos/quote NO admite este modelo; su validación actual es específica de Seedance. Omni no tiene un contrato admitido de presupuesto gratuito sin tarea/generador, ni invoice específico ni /v1/videos/{task_id}/billing como factura final. Siguen vigentes moderación y restricciones regionales del proveedor, incluidas las de edición/extensión de vídeos subidos en EEA, Suiza y Reino Unido. La especificación enlazada describe el gateway; los ejemplos nativos no sustituyen IDs, respuestas y registros de APIMaster.

APIMart · Gemini Omni 1.2 Flash