Documentação
Introdução
Bem-vindo
Bem-vindo
A AIVAX é uma plataforma de orquestração de IA para criar, operar e avaliar aplicações de IA. Ela oferece uma conta, uma …
Autenticação
Autenticação
A AIVAX autentica solicitações de API com chaves de API da conta. Uma chave de login é uma credencial separada e serve apenas …
OAuth
OAuth
O OAuth permite que seu aplicativo utilize a conta AIVAX de uma pessoa para seus recursos de IA. Em vez de criar seu próprio acesso ao …
Ferramenta de linha de comando
Ferramenta de linha de comando
O CLI do AIVAX opera uma conta do AIVAX diretamente no terminal. Ele abrange os mesmos produtos da API, …
Preços
Preços
A AIVAX cobra o uso do saldo da conta em USD. Cada produto documenta suas próprias tarifas em uma seção de preços dedicada, vinculada …
Planos e Limites
Planos e Limites
A AIVAX possui quatro planos de conta: Gratuito, Pro, Max e Ultimate. O plano atual controla o acesso ao modelo, os limites …
Compartilhamento de Dados
Compartilhamento de Dados
AIVAX oferece um programa opcional de coleta semântica de dados para contas que optam por contribuir com dados …
RAG e coleções
Coleções
Coleções
A AIVAX oferece um serviço de RAG (Geração Aumentada por Recuperação) para armazenar conhecimento e recuperá-lo posteriormente por …
Documentos
Documentos
Um documento é a unidade que o AIVAX indexa e recupera dentro de uma coleção. Cada documento armazena texto, uma referência …
Pesquisar
Pesquisa
A pesquisa retorna documentos indexados de uma ou mais coleções. Utilize a pesquisa gerenciada quando o AIVAX deve armazenar e …
Filtros Avançados
Filtros Avançados
Um filtro avançado, também chamado de filtro de documento, restringe uma busca RAG aos documentos que atendem a uma …
Observabilidade de RAG
Observabilidade de RAG
O Console AIVAX mostra como suas coleções são indexadas, quais buscas elas recebem e quão bem essas buscas pontuam. …
Rerankers
Rerankers
Os rerankers reordenam um conjunto existente de documentos candidatos para uma consulta. Eles não buscam em uma coleção nem …
Reflexo
Reflex
Reflex é a busca sem coleções do AIVAX para RAG. Envie uma consulta junto com strings de documentos candidatos e receba os itens mais …
Inferência
Conceitos de Gateway de IA
Conceitos do Gateway de IA
Um Gateway de IA armazena uma configuração de inferência reutilizável. Passe o ID ou slug do gateway no campo …
Nomes de Modelos e Gateways
Nomes de modelos e gateways
O campo model de /v1/chat/completions seleciona o que executa a solicitação. Ele aceita três tipos de valor: …
Usando um Gateway de IA
Usando um Gateway de IA
Crie um gateway no painel ou com a API, e chame-o por meio do endpoint chat/completions compatível com OpenAI, …
Usando Gateways de IA por meio de SDKs
Usando Gateways de IA via SDKs
O endpoint de inferência segue o formato de conclusões de chat do OpenAI, portanto, os SDKs compatíveis com o …
Levando um Gateway de IA para Produção
Levando um Gateway de IA para produção
Comece com uma configuração conservadora: instruções de sistema claras, um modelo que suporte as …
Conceitos de Inferência
Conceitos de inferência
A AIVAX expõe uma API chat/completions compatível com OpenAI, com parâmetros adicionais da AIVAX. As adições são …
Contexto do lado do servidor
Contexto do lado do servidor
chat/completions é sem estado: cada solicitação carrega a conversa que precisa, e o AIVAX não mantém um …
Reutilização de Sessão
Reutilização de sessão
A reutilização de sessão permite que um cliente chat/completions sem estado mantenha o contexto do lado do servidor …
Inferência com Gateways de IA
Inferência com Gateways de IA
Um Gateway de IA pré-configura uma inferência. Quando model é um ID ou slug de gateway, a solicitação que você …
Pipeline de Processamento
Pipeline de processamento
Quando uma solicitação utiliza um AI Gateway, o AIVAX executa uma sequência fixa de etapas antes, durante e após a …
Entrada e Multimodalidade
Entrada e multimodalidade
Envie a conversa em messages, utilizando os papéis do OpenAI system, user, assistant e tool. Com um Gateway de IA, …
Armazenamento em cache
Caching
Vários caches afetam uma solicitação de inferência. O cache de prompt reduz o custo da entrada que o provedor já processou. Outros …
Ferramentas
Ferramentas
As ferramentas permitem que o modelo solicite ações e dados. O AIVAX suporta dois modelos de execução, e uma única solicitação …
Funções do MCP e Protocolos na Inferência
MCP e funções de protocolo na inferência
As ferramentas MCP e as funções de protocolo são ferramentas do lado do servidor que chamam seus …
Saída Estruturada
Saída estruturada
Use respostas estruturadas quando seu aplicativo precisar de uma saída JSON que corresponda a um esquema. O AIVAX oferece …
Ferramentas Integradas sob Demanda
Ferramentas integradas sob demanda
Use builtin_tools para habilitar as ferramentas integradas do AIVAX em uma solicitação direta, sem criar …
Streaming
Streaming
Defina stream: true para receber a resposta como eventos enviados pelo servidor (SSE) enquanto ela é gerada. Cada evento é uma …
Corpo da Solicitação do Provedor Personalizado
Corpo da solicitação do provedor personalizado
Use extra_body para enviar opções específicas do provedor. Quando um gateway usa sua própria …
Pré-processamento Multimodal
Pré-processamento multimodal
Use multimodal_resolver quando o modelo principal deve receber uma descrição textual da mídia em vez do objeto …
Truncamento de Contexto
Truncamento de contexto
O truncamento de contexto mantém conversas longas dentro de um tamanho máximo de entrada. Um Gateway de IA pode …
Moderação
Moderação
A moderação aplica a política de segurança às solicitações dos usuários antes que o modelo principal as responda. Utilize-a para …
Interpretador de Funções (Descontinuado)
Interpretador de funções (descontinuado)
Descontinuado. O interpretador de funções é mantido apenas para gateways existentes. Não o utilize …
Limites de Inferência
Limites de inferência
Esta página lista os limites aplicáveis às solicitações chat/completions. As taxas de solicitação e os limites do …
Solução de Problemas de Inferência
Solução de problemas de inferência
A AIVAX utiliza dois estilos de resposta:
Endpoints compatíveis com OpenAI retornam um objeto error no …
Configuração de Roteamento do Provedor
Configuração de roteamento de provedores
Alguns modelos integrados estão disponíveis por meio de mais de um provedor. O roteamento de …
Roteamento Inline
Roteamento inline no nome do modelo
Um nome de modelo integrado aceita um sufixo de roteamento após o #. Use-o quando seu cliente puder …
Provedores de Retenção Zero de Dados
Apenas provedores com retenção zero de dados
Ative a opção Apenas provedores com retenção zero de dados nas configurações da conta no painel …
Provedores Especiais
Provedores especiais
Alguns modelos integrados também são oferecidos por provedores especiais, que os fornecem a preços com desconto sob …
Conceitos de Respostas Estruturadas
Conceitos de respostas estruturadas
A AIVAX pode gerar JSON estruturado por meio de dois caminhos:
response_schema: A AIVAX valida a saída …
Cura em JSON
Cura de JSON
A Cura de JSON (JSON Healing) é o recurso do AIVAX que faz qualquer modelo retornar um JSON compatível com um esquema, …
Respostas Estruturadas com Raciocínio e Ferramentas
Raciocínio e ferramentas
Uma solicitação estruturada pode usar um modelo de raciocínio e ferramentas. O modelo raciocina e chama ferramentas …
Respostas Apenas em JSON
Respostas apenas em JSON
Defina json_only: true quando o cliente deve receber apenas o JSON gerado:
JSON
{ "model": …
Orientações para Apresentação de Chat
Orientações para apresentação do chat
Uma resposta de assistente transmitida em streaming pode conter raciocínio, atividade de ferramentas …
Exemplo de múltiplas rodadas bruto
Exemplo bruto de múltiplas rodadas
O exemplo abaixo mostra a estrutura de uma resposta em streaming quando o raciocínio do lado do servidor …
Explicações das Ferramentas
Explicações de ferramentas
Use explicações de ferramentas quando seu cliente mostrar aos usuários por que uma ferramenta do lado do servidor …
Visão Geral dos Clientes de Chat
Visão geral dos clientes de chat
Um cliente de chat publica uma AI Gateway para os usuários finais. Ele oferece um local para conversar com …
Gerenciando Sessões do Cliente de Chat
Gerenciando sessões do cliente de chat
Uma sessão é uma única conversa entre um cliente de chat e um usuário final. Ela armazena o histórico …
Cliente de Chat Web
Cliente de Chat Web
O cliente web é a parte do cliente de chat voltada para o navegador. Você pode usá-lo de duas maneiras:
Chat web …
Integrações do Cliente de Chat
Integrações de Cliente de Chat
As integrações conectam um cliente de chat a aplicativos de mensagens, permitindo que os usuários conversem …
Visão Geral dos Modelos de Assinatura
Modelos de assinatura
Os modelos de assinatura são modelos de texto incluídos nos planos Pro, Max e Ultimate. Seus nomes começam com …
Integração com Harness
Integração com harness
Agentes de codificação e outros harnesses acessam os modelos de assinatura pela mesma API de Chat Completions …
Testes Agênticos
Testes Agênticos
Testes Agênticos avaliam como um Gateway de IA se comporta ao longo de uma conversa completa e orientada a objetivos, em …
Voz e Tempo Real
Voz e Tempo Real
A Sessão de Voz é a API de voz com baixa latência e estado persistente da AIVAX. Use-a para uma conversa falada ao vivo. …
Trabalhadores de Gateway
Gateway Workers
Os Gateway Workers são hooks HTTP que permitem ao seu serviço controlar um AI Gateway enquanto uma solicitação está em …
Habilidades
Habilidades
As habilidades (também conhecidas como capacidades) são instruções que seu agente carrega sob demanda para realizar tarefas …
Processamento em Lote
Processamento em Lote (Batch)
O Batch executa o mesmo fluxo de trabalho de IA sobre muitos itens independentes. Ele transforma uma lista de …
Fundação Web
Pesquisa na Web
Pesquisa na Web
A Pesquisa na Web recupera informações atualizadas da internet para pesquisa, verificação de fatos e respostas que exigem …
Buscar e fazer OCR
Buscar e OCR
A busca e o OCR extraem texto legível de páginas da web e documentos compatíveis, para que aplicativos e agentes possam usar …
Geração de mídia
Geração de Imagens
Geração de Imagens
Use a Geração de Imagens para criar imagens a partir de um prompt de texto em um fluxo de trabalho de aplicativo. Os usos …
Texto para Fala (TTS)
Texto para Fala (TTS)
Use a Geração de Fala quando seu aplicativo já tiver o texto final e precisar de áudio reproduzível sem executar uma …
Fala para Texto (STT)
Fala para Texto (STT)
Use Transcrições de Áudio para converter fala gravada em texto para busca, revisão, legendas ou automação posterior. …
Processamento de Dados
Descrições de Mídia
Descrições de Mídia
Use Descrições de Mídia quando um aplicativo precisar de informações estruturadas a partir de áudio, imagens, vídeo ou …
Decisões Semânticas
Decisões Semânticas
Decisões semânticas avaliam perguntas nomeadas contra um estado compartilhado e retornam respostas estruturadas em vez …
Classificação de Texto
Classificação de Texto
Use a classificação de texto para ranquear um conjunto fixo de rótulos para um ou mais documentos sem treinar um …
Segmentação de Texto
Segmentação de Texto
A segmentação de texto divide documentos fonte em strings semanticamente coesas que podem ser incorporadas ou indexadas …
Extração
Extração
Use a Extração para transformar texto, imagens e PDFs em JSON moldado por um esquema que você define. Ela se adapta a faturas, …
Resumo
Resumo
Use o recurso de Resumo para condensar textos, imagens e PDFs em resumos curtos, opcionalmente guiados por instruções sobre formato, …
Traduções
Traduções
Use as Traduções para traduzir texto, o texto visível em imagens e a fala em áudio para qualquer idioma. É adequado para conteúdo …
Refinamento de Instrução
Refinamento de Instrução
Use o Refinamento de Instrução para revisar instruções do sistema, prompts e habilidades antes de enviá-los a um …
Ferramentas
Ferramentas integradas
Ferramentas Integradas
As ferramentas integradas são capacidades mantidas pela AIVAX, como busca na web, leitura de URLs, execução de …
Suporte para o Protocolo de Contexto do Modelo (MCP)
Suporte ao Protocolo de Contexto do Modelo (MCP)
O MCP vincula ferramentas externas a um Gateway de IA. Utilize-o quando o assistente …
Funções de Protocolo
Funções de Protocolo
As funções de protocolo são ferramentas do lado do servidor do AIVAX. O modelo solicita uma ação nomeada, e o AIVAX a …
Sandboxing de Shell
Sandboxing de Shell
A AIVAX oferece um ambiente de shell virtual que pode ser utilizado por assistentes de agente para executar comandos de …
Utilitários MCP
Coleções e RAG MCP
Coleções e RAG MCP
O MCP de Coleções expõe uma ou mais coleções AIVAX RAG como ferramentas para clientes MCP compatíveis. Use-o quando um …
Documentação MCP
Documentação MCP
O MCP de documentação da AIVAX expõe a documentação da AIVAX, o conteúdo de referência da API e os metadados do modelo para …
Gerenciamento de conta MCP
Gerenciamento de conta MCP
O MCP de gerenciamento de conta expõe operações selecionadas da conta AIVAX a um cliente compatível com MCP, como …
Fundação Web MCP
Web Foundation MCP
O MCP de utilidades web expõe ferramentas de recuperação da AIVAX a qualquer cliente compatível com MCP. Utilize-o quando …
Geração de mídia MCP
Geração de mídia MCP
O MCP de geração de mídia oferece a um cliente MCP hospedado geração de imagens e geração de fala (texto-para-fala). …
Inferência MCP
Inference MCP
O Inference MCP expõe um modelo integrado do AIVAX ou um Gateway de IA como uma ferramenta para clientes MCP compatíveis. …
Documentos legais
Política de Privacidade
Política de Privacidade
Revisão: 1.4 Data de vigência: 1º de agosto de 2026 Atualização anterior: 20 de julho de 2026 Última atualização: 26 …
Termos de Uso
Termos de Uso
Revisão: 1.4 Data de vigência: 1º de agosto de 2026 Atualização anterior: 20 de julho de 2026 Última atualização: 26 de …
Processadores de Dados
Processadores de Dados
A AIVAX utiliza serviços de terceiros para operações específicas, como infraestrutura, armazenamento de objetos, …
Registros de alterações
Changelogs
Alterações técnicas que afetam os produtos, serviços ou a API pública da AIVAX. As datas indicam quando as entradas foram …
