Gemini Omni 1.2 Flash

Contrato do gateway APIMaster para gemini-omni-1.2-flash, verificado em 2026-11-07. Não é a API nativa Google Interactions. As regras Official/Ext da versão 1.1 não se aplicam.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

Rotas e autenticação

A rota pública atual é o canal 335. Use Authorization: Bearer YOUR_API_KEY e Content-Type: application/json. Permissões de modelo/grupo, saldo e disponibilidade continuam valendo; não há lista adicional de clientes autorizados publicada. Não acrescente o canal ao ID. Não existe rota Ext separada para 1.2; estar listado não significa expor todos os recursos do 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 e limites

Campo	Tipo	Regra
model	string	ID público exato do modelo.
prompt	string	Instrução não vazia obrigatória em todos os modos, inclusive edição e continuação.
duration	integer	Padrão 10; geração normal 3–15 segundos inteiros; interpolação e novo trecho de extensão 3–10. Ignorado na edição.
seconds	integer / string	Alias de duration, inteiro ou texto de inteiro; duration tem prioridade se ambos forem enviados.
resolution	string	360p, 720p (padrão), 1080p ou 4k, sem diferenciar maiúsculas; 2160p vira 4k. 1080p/4k são ampliados.
aspect_ratio	string	16:9 por padrão ou 9:16. Outras strings são atualmente normalizadas para 16:9; envie somente valores suportados.
ratio	string	Alias antigo de proporção, não resolução; prefira aspect_ratio.
size	string	Alias antigo; prioridade aspect_ratio, ratio, size.
image_urls	string[]	URLs públicas HTTP(S) de imagens; uma inicia a cena por padrão, várias são referências.
first_frame_image	string	URL pública do primeiro quadro.
last_frame_image	string	Exige first_frame_image; proporções devem combinar com a saída.
image_with_roles	object[]	Alternativa aos campos de quadros. Cada objeto tem url e role não vazio; first_frame/last_frame indicam início/fim, outros papéis são referências. O último exige o primeiro.
video_urls	string[]	No máximo um vídeo público de entrada com até 15 segundos; edição por padrão.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. Extensão exige extend explícito.
extend_from_task_id	string	ID público task_... de uma tarefa sua concluída deste modelo; exclui video_urls. Canal e conta originais precisam continuar disponíveis. Não é Google interaction ID.

Até 10 imagens no total, incluindo quadros. Escolha image_with_roles ou os campos explícitos. O fornecedor recomenda até dois personagens e três imagens de cada um. Apenas URLs HTTP(S) públicas diretas; sem Base64, Data URL ou multipart. PNG/JPEG e MP4 foram validados. A inspeção de duração aceita mídia compatível com MP4/MOV e lê até 100 MiB; isso não garante um limite de upload do fornecedor. Não há limite publicado por imagem nem contrato completo de codecs e tamanhos.

Referências de áudio, audio_urls, estado Google interaction/conversation, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps e n não são suportados. Descreva restrições negativas e áudio desejado em prompt. Tarefas públicas concluídas podem ser encadeadas, mas cada vídeo de entrada continua limitado a 15 segundos; não é sessão nativa do Google. Campos superiores desconhecidos são rejeitados.

Exemplos JSON sem execução

São corpos JSON inertes, não scripts. Substitua example.com e IDs ilustrativos. Cada operação nova usa chave nova; repetir a mesma operação conserva chave e corpo. No próximo turno use o ID público da tarefa filha concluída. Não existe exemplo válido de entrada de áudio.

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

Tarefas, consulta e download

O primeiro POST aceito retorna HTTP 200 e queued. Consulte a cada 5–10 segundos: queued → in_progress → completed/failed; trate também unknown transitório. url e metadata.url são proxies autenticados; baixe com Bearer. Falhas de geração normalmente retornam HTTP 200 e error.code=generation_failed, com mensagem sanitizada. Erros de envio usam 4xx/5xx. Timeout ou 5xx não provam que a solicitação não foi aceita. Os exemplos substituem identificação e horário.

{"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, custo final e reembolsos

A consulta não garante usage, modalidades ou total USD. Após conciliação, o custo final do cliente está em other.final_amount_usd no log de consumo. GET /api/log/token com a mesma chave fornece uma lista recente limitada, não um arquivo de faturas. GET /api/log/self para histórico da conta exige autenticação da conta; a chave de geração não a substitui. Analise a string other como JSON e associe other.task_id. Com uso real podem existir prompt_tokens, completion_tokens e other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices, group_ratio. A entrada é agregada, sem detalhamento texto/imagem/vídeo garantido.

Em 2026-11-07, as tarifas-base do canal 335 são $1.32 entrada, $7.92 saída de texto e $10.56 saída de vídeo por milhão de tokens, antes dos multiplicadores de conta; consulte a ficha atual. O envio reserva uma estimativa, depois ajustada pelo uso real e preços congelados, com cobrança adicional ou reembolso. Falha confirmada devolve a reserva; aceitação incerta não garante reembolso imediato. 500,000 quota = USD 1. Não trate reserva inicial como total final nem some novamente os ajustes ao valor final. Exemplo histórico: entrada 39, texto 0, vídeo 5793, final $0.064286; não é cotação fixa nova.

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

A extensão cobra saída de vídeo do trecho novo e entrada do vídeo de referência; o MP4 contém ambos. Foi validado um original de 3 segundos mais 3 novos: arquivo de cerca de 6 segundos, tokens de saída pelos novos 3. Áudio gerado faz parte da saída de vídeo. Sem detalhes de texto, o parser atual considera a saída informada como vídeo. Sem tokens válidos mas com recibo de custo autoritativo, pode liquidar pelo recibo, token_usage_source=provider_cost_receipt, sem inventar contadores. Sem uso nem custo a conciliação continua. Não há garantia de contadores completos ou prazo fixo de liquidação.

Idempotência do gateway e recuperação

Idempotency-Key tem 8–128 caracteres ASCII visíveis sem espaços, sem equivalente no corpo e com escopo por conta. Mesma conta/chave/requisição: HTTP 202 e Idempotency-Replayed:true, sem segunda geração nem reserva. Alterar corpo, grupo ou rota explícita: 409 idempotency_conflict. A ordem das chaves JSON é ignorada; valores, ordem dos arrays e padrões omitidos/explícitos contam. Após desconexão, o gateway tenta concluir o envio original e persistência dentro de execução limitada.

{"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 com chave original e Bearer apenas lê o recibo: não chama gerador, não busca por chave no fornecedor e não movimenta fundos. pending/submitting: continue lendo; accepted com task_ready=true: consulte task_id; accepted não pronto: aguarde conciliação ou suporte; acceptance_unknown: não reenvie automaticamente, preserve chave e referência; not_accepted: corrija erro confirmado e use nova chave apenas se recibo e fundos permitirem. A antiga continua reproduzindo o resultado original. 404 com retry_safe=false não prova não aceitação. Retenção mínima de 30 dias, sem reutilização automática. Repetir POST sem chave do cliente cria nova operação. É idempotência do gateway, não nativa de Google/APIMart; originais incertos nunca são reenviados automaticamente. Tarefas aceitas e financeiramente confirmadas podem ser restauradas sem nova geração ou cobrança.

Recursos indisponíveis e orçamento

POST /v1/videos/quote NÃO suporta este modelo: a validação atual é específica de Seedance. Não há orçamento Omni gratuito suportado sem tarefa/gerador, nem invoice dedicado ou /v1/videos/{task_id}/billing como fatura final. Moderação e restrições regionais continuam aplicáveis, incluindo edição/extensão de vídeos enviados em EEA, Suíça e Reino Unido. O schema vinculado descreve o gateway; exemplos nativos não substituem IDs, respostas e logs APIMaster.

APIMart · Gemini Omni 1.2 Flash