Source: https://ailoot.ai/models/pt-pt/google-gemini-2-5-flash-u003a-batch/ Canonical: https://ailoot.ai/models/pt-pt/google-gemini-2-5-flash-u003a-batch/ Language: pt-pt # Google: Gemini 2.5 Flash (batch) [Markdown](https://ailoot.ai/models/pt-pt/google-gemini-2-5-flash-u003a-batch/index.md) · [JSON](https://ailoot.ai/models/pt-pt/google-gemini-2-5-flash-u003a-batch/facts.json) ## [Google: Gemini 2.5 Flash (batch)](https://ailoot.ai/models/pt-pt/google-gemini-2-5-flash-u003a-batch/) Gemini 2.5 Flash é o modelo estável de raciocínio híbrido da Google para análise multimodal e tarefas de agentes. O seu orçamento dinâmico de pensamento pode ser definido entre 0 e 24 576 tokens, incluindo um modo desligado. Texto, imagens, áudio, vídeo e documentos tornam-se texto ou resultados estruturados, com um limite de entrada documentado de 1 048 576 tokens. - [**Ailoot Ultra · Processamento em lote** `POST /v1/batches` `google/gemini-2.5-flash:batch`](https://ailoot.ai/models/pt-pt/google-gemini-2-5-flash-u003a-batch/#method-0) Sobre o modelo Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo. Gemini 2.5 Flash é o perfil estável de raciocínio híbrido da Google para trabalho multimodal abrangente e utilização de ferramentas por agentes. Oferece respostas com e sem pensamento para tarefas multimodais em grande escala que precisam de níveis diferentes de raciocínio. Texto, imagens, áudio e vídeo contribuem para uma resposta textual. A entrada documental está também descrita no perfil cloud específico do modelo da Google. Um resultado útil pode ser uma comparação documental, um gráfico interpretado, uma transcrição, código ou um registo estruturado. O controlo de raciocínio da edição utiliza thinkingBudget. O pensamento dinâmico é a predefinição; uma definição de -1 permite ao modelo adaptar o raciocínio à complexidade da tarefa. Um orçamento explícito pode variar entre zero e 24 576 tokens, e zero desativa o pensamento. Escolha um orçamento adequado ao problema real, em vez de atribuir o mesmo esforço a uma categorização simples e a uma análise com várias condições. O guia trata o orçamento como orientação, e a ficha nativa observa que o cumprimento pode não ser exato. Para uma tarefa documental ou de dados, defina a pergunta, os campos obrigatórios e as provas que devem acompanhar o resultado. Para uma comparação de requisitos, compare duas especificações e devolva o requisito alterado, a respetiva passagem de origem e o efeito num fluxo de trabalho indicado. A saída estruturada é útil quando cada conclusão precisa da mesma forma de registo. Se a fonte apresentar vários valores possíveis ou deixar um campo em aberto, preserve essa incerteza, em vez de forçar uma única resposta plausível. Reveja os valores devolvidos face às páginas ou aos dados fornecidos. Para material visual ou áudio, identifique o objeto, rótulo, acontecimento ou passagem de gravação relevantes. Peça o tipo de texto necessário: valores visíveis de um gráfico, uma descrição de um acontecimento, uma transcrição ou um resumo. Estes artefactos são diferentes, e a instrução deve dizer qual produzir. A ficha nativa partilhada inclui Flash Image e Flash Audio como capacidades identificadas separadamente; as suas saídas de imagem e voz geradas não fazem parte deste perfil textual estável. O perfil cloud exato da Google documenta entradas PDF e texto simples com limites específicos da interface: 50 MB por PDF importado através da API e até 3 000 páginas por ficheiro, com um limite de 7 MB para ficheiros de texto simples. Esse perfil descreve também aproximadamente 45 minutos de vídeo com áudio ou uma hora sem áudio, e aproximadamente 8,4 horas de áudio dentro da margem de entrada de um milhão de tokens. Estas são as restrições declaradas da interface cloud, separadas da janela geral de tokens do modelo. Prepare a secção relevante e o formato de origem, em vez de pressupor que todos os tipos de ficheiro ou percursos de carregamento têm o mesmo limite. A tabela exata da Gemini API apresenta chamadas de funções, execução de código, pesquisa em ficheiros, fundamentação por pesquisa, fundamentação com Maps, contexto de URL e saídas estruturadas. Defina a finalidade e a estrutura dos parâmetros de cada função e continue a partir do resultado real devolvido. Um modelo pode pedir uma operação, enquanto a aplicação ligada a executa. Preserve o contexto necessário de assinaturas de pensamento ao continuar uma tarefa de raciocínio na interface sem estado. Uma resposta estruturada ou uma sugestão de função não estabelecem independentemente que uma operação externa tenha sido bem-sucedida. A ficha nativa do modelo indica contexto de 1M e saída textual de 64K, enquanto a tabela exata da API especifica 1 048 576 tokens de entrada e 65 536 tokens de saída. Um limite de resposta inclui tokens de pensamento, pelo que um limite demasiado pequeno pode deixar a resposta final truncada ou vazia. Peça um artefacto dimensionado para a margem de saída e utilize o orçamento de raciocínio para orientar o esforço. A cache, o processamento em lote, Flex e Priority estão documentados para este perfil do produtor. Preserve os identificadores dos itens ao preparar vários registos independentes. A edição estável mantém-se distinta de variantes Flash Preview e de modelos Gemini 3 posteriores. A sua ficha apresenta possíveis alucinações, limitações na compreensão causal e no raciocínio lógico complexo ou contrafactual, e uma data-limite de conhecimento de janeiro de 2025. Forneça provas recentes quando uma tarefa depender de informação mais nova. Verifique cálculos, valores extraídos, transcrições e código proposto face à fonte ou ao resultado de execução reais. O pensamento híbrido é útil quando sustenta esse resultado concreto, em vez de se tornar um substituto da sua revisão. **Ailoot Ultra · Processamento em lote** `POST /v1/batches` `google/gemini-2.5-flash:batch` [`google/gemini-2.5-flash:batch`](https://ailoot.ai/models/pt-pt/#m=google%2Fgemini-2.5-flash%3Abatch&route=Ultra&caller=google%2Fgemini-2.5-flash%3Abatch&fmt=batches) Google /`google/gemini-2.5-flash:batch` ### Introdução Gemini 2.5 Flash é o modelo estável de raciocínio híbrido da Google para análise multimodal e tarefas de agentes. O seu orçamento dinâmico de pensamento pode ser definido entre 0 e 24 576 tokens, incluindo um modo desligado. Texto, imagens, áudio, vídeo e documentos tornam-se texto ou resultados estruturados, com um limite de entrada documentado de 1 048 576 tokens. Entradas aceites Texto Resultados Texto ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Processamento em lote** `POST /v1/batches` Entrada `text` Saída `text` Formato de saída JSON em linha de results\[\].response.body | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`endpoint` | Tipo`string` | RequisitoObrigatório | Valores e limites /v1/chat/completions | Predefinição— | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites google/gemini-2.5-flash:batch | Predefinição— | | Campo`requests` | Tipo`batch_item[]` | RequisitoObrigatório | Valores e limites Número mínimo de elementos: 1 | Predefinição— | | Campo`requests[].custom_id` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`requests[].body.messages` | Tipo`message[]` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`completion_window` | Tipo`string` | RequisitoOpcional | Valores e limites 24h | Predefinição— | | Campo`provider` | Tipo`object\|null` | RequisitoOpcional | Valores e limites | Predefinição— | Parâmetros e ciclo de vida do método | Parâmetro | Contrato | | --- | --- | | Parâmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratoendpoint, model, requests | | Parâmetro`material_types` | Contratotext | | Parâmetro`representation` | Contratorequests\[\] em linha; cada item tem custom\_id e body | | Parâmetro`request_endpoint_profile` | Contrato/v1/chat/completions | | Parâmetro`file_material` | ContratoQuem faz a chamada pode ler localmente o conteúdo JSONL UTF-8 efetivo para requests\[\]. Não é utilizada qualquer finalidade de carregamento, input\_file\_id ou referência a ficheiro. Se o material do cliente estiver em falta ou vazio, a preparação é interrompida antes do POST. | | Parâmetro`serialization_order` | Contratoendpoint, model, provider (se fornecido), completion\_window (se fornecido), requests em último lugar | | Parâmetro`optional_controls` | Contratoprovider.only, provider.allow\_fallbacks, completion\_window | | Parâmetro`schema_scope` | ContratoCorpos de pedidos de texto de Chat Completions na estrutura de lote em linha documentada. | Ciclo de vida: `asynchronous` `GET /v1/batches/{operation_id}` · response.id efetivo da resposta original de criação; mesmo utilizador/chave/grupo ### Tarifários As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado. Modo rápido Não especificado Quando o modo rápido está selecionado Modo flex Não especificado Quando o modo flex está selecionado Esforço máximo de raciocínio Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default) Preços da cache explícita Não ativado Quando é pedida cache explícita #### Tarifas Ailoot #### Preços por configuração Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas. | Configuração | Tabela de tarifas | Tokens de contexto, mais de | Tokens de contexto, até ao limite inclusive | Custo | | --- | --- | --- | --- | --- | | ConfiguraçãoTarifas base dos tokens | Tabela de tarifasTarifa base | Tokens de contexto, mais de— | Tokens de contexto, até ao limite inclusiveSem limite superior | Custo Entrada · Tokens de entrada **$0.0003** / 1K tokens Saída · Tokens de saída **$0.0025** / 1K tokens Entrada · Leitura da cache **$0.00006** / 1K tokens Entrada · Escrita na cache **—** / 1K tokens Entrada · Escrita na cache, 1 hora **—** / 1K tokens | | ConfiguraçãoEscalão 1 por comprimento do pedido | Tabela de tarifas— | Tokens de contexto, mais de0 | Tokens de contexto, até ao limite inclusiveSem limite superior | Custo Entrada · Tokens de entrada **$0.0003** / 1K tokens Saída · Tokens de saída **$0.0025** / 1K tokens Entrada · Leitura da cache **$0.00006** / 1K tokens Entrada · Escrita na cache **—** / 1K tokens Entrada · Escrita na cache, 1 hora **—** / 1K tokens | O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/) ### Exemplos de pedidos #### Ailoot Ultra · Processamento em lote curl · dados de teste preservadosPython HTTP · JSONL real do cliente ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json from pathlib import Path body=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-2.5-flash:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}') Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8") PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json ``` ```python import json, os from pathlib import Path from urllib.request import Request, urlopen def prepare_requests(customer_path): path = Path(customer_path) if not path.is_file(): raise ValueError("Customer JSONL file is missing") items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()] if not items: raise ValueError("Customer JSONL contains no requests") ids = set() for item in items: if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body") cid = item["custom_id"] if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique") ids.add(cid) if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages") return {"endpoint":"/v1/chat/completions", "model":"google/gemini-2.5-flash:batch", "requests":items} if __name__ == "__main__": material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "") if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file") body = prepare_requests(material) key = os.environ.get("AILOOT_API_KEY", "") if not key: raise SystemExit("Set AILOOT_API_KEY") request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST") with urlopen(request) as response: raw = response.read() Path("batch-create-response.json").write_bytes(raw) print(raw.decode("utf-8")) ``` ### Receber e guardar os resultados #### Ailoot Ultra · Processamento em lote JSON em linha de results\[\].response.body - `GET /v1/batches/{operation_id}` ##### Verificar o estado da tarefa curl · estado da operação original ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" BATCH_OPERATION_ID="$(python3 - <<'PY_ID' import json from pathlib import Path from urllib.parse import quote response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8")) operation = response.get("id") if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit") print(quote(operation, safe="")) PY_ID )" curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \ -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json ``` ##### Guardar todos os resultados concluídos Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra. Conserve todos os resultados, corpos de resposta/erro, opções e a utilização agregada. ##### Se for necessário verificar a resposta original Preserve o ID original da operação. A resposta 503 result\_pending\_check inclui X-Should-Retry:false; nunca volte a enviar um lote original de estado desconhecido. Campos da resposta | Campo | Tipo | | --- | --- | | Campo`results[].custom_id` | Tipostring | | Campo`results[].response.body.choices[].message.content` | Tipostring\|null | | Campo`results[].error` | Tipoobject\|null | | Campo`usage` | Tipoobject\|null | ### Aliases #### Aliases do modelo **Ailoot Ultra** [`google/gemini-2.5-flash:batch`](https://ailoot.ai/models/pt-pt/#m=google%2Fgemini-2.5-flash%3Abatch&route=Ultra&caller=google%2Fgemini-2.5-flash%3Abatch&fmt=batches) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`google/gemini-2.5-flash:batch`](https://ailoot.ai/models/pt-pt/#m=google%2Fgemini-2.5-flash%3Abatch&route=Ultra&caller=google%2Fgemini-2.5-flash%3Abatch&fmt=batches) FAQ · Google: Gemini 2.5 Flash (batch) Que entradas e resultados estão disponíveis? `POST /v1/batches` · `google/gemini-2.5-flash:batch`: `text` → `text` Que campos utiliza o pedido? `POST /v1/batches` · `google/gemini-2.5-flash:batch`: `endpoint`, `model`, `requests`, `completion_window`, `provider` Que limites se aplicam? `POST /v1/batches` · `google/gemini-2.5-flash:batch`: `requests.min_items`: `1` Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação. ## A empresa e a sua carteira de projetos A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. ## Compre tokens com desconto. Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens. Subscrição Escolha um plano com desconto para os pedidos regulares. Código promocional até 50% Introduza o código na compra. O preço é recalculado conforme a campanha em vigor. Custos no histórico O modelo, os tokens e o montante são guardados para cada pedido. [Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## Ligue a API ao produto que vende. SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor. Aplicação comercial Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço. Licença de revendedor Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda. Documentos no site A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação. [Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.