Guia Rápido

Motor IAEO API

A API do Motor IAEO permite integrar inteligência artificial diretamente nos seus sistemas, produtos e fluxos de trabalho. Com uma única chamada HTTP, você acessa agentes de IA configurados sob medida para o seu negócio — atendimento ao cliente, vendas, análise de dados e muito mais.

O que é a API IAEO?

A IAEO oferece uma plataforma de IA como Serviço (AIaaS) onde cada cliente possui módulos de IA personalizados. Através da API REST, sua aplicação pode enviar contexto (dados do cliente, histórico, perguntas) e receber respostas inteligentes geradas pelos modelos de linguagem mais avançados do mercado.

Diferente de usar a API da OpenAI ou Claude diretamente, a API da IAEO já vem com prompts otimizados, ferramentas integradas e contexto do seu negócio pré-configurados. Você não precisa se preocupar com engenharia de prompt — apenas envie os dados e receba a resposta pronta.

Como funciona?

1. Autentique

Use sua API Key no header Authorization de cada requisição. Cada chave tem permissões e limites configurados.

2. Envie contexto

Faça um POST com os dados relevantes (nome do cliente, pergunta, produto, etc). O módulo de IA já sabe como usar esses dados.

3. Receba a resposta

A API retorna a resposta gerada pela IA, com métricas de uso (tokens, custo) para total transparência e controle.

Base URL

https://api.iaeo.com.br/v1

Todas as requisições devem ser feitas para esta URL base, seguida do slug da sua conta e do endpoint desejado.

Autenticação

A API utiliza Bearer Token para autenticação. Inclua sua API Key em todas as requisições:

Header de autenticação
Authorization: Bearer SUA_API_KEY

Importante: Nunca exponha sua API Key no frontend (código JavaScript do navegador). Faça as chamadas pelo seu backend.

Recursos principais

Módulos personalizados— Cada módulo tem prompts, modelo de IA e ferramentas configurados especificamente para um caso de uso do seu negócio.
Ferramentas integradas— Os agentes de IA podem acessar ferramentas como busca de produtos, consulta de pedidos, cálculo de frete e mais — tudo configurado no painel.
Modo conversa— Envie um conversation_id para manter o contexto entre requisições, criando experiências de chat completas.
Streaming (SSE)— Ative o modo stream para receber a resposta em tempo real via Server-Sent Events, ideal para interfaces de chat.
Métricas transparentes— Cada resposta inclui tokens consumidos e custo. Use o endpoint /usage para relatórios completos do período.
Rate limiting inteligente— Limites configuráveis por plano. Em caso de excesso, a API retorna retry_after para que seu sistema saiba quando tentar novamente.

Primeiros passos

1

Solicite suas credenciais

Entre em contato para criar sua conta e receber sua API Key. Oferecemos um período de teste gratuito para validar a integração.

2

Configure seus módulos

No portal do cliente, configure o comportamento do agente de IA: modelo, prompt, ferramentas e parâmetros. Nosso time auxilia na configuração inicial.

3

Faça sua primeira chamada

Teste com uma requisição simples:

Primeira requisição
#ce93d8">curl -X POST https://api.iaeo.com.br/v1/{seu-slug} \
  -H #a5d6a7">"Content-Type: application/json" \
  -H #a5d6a7">"Authorization: Bearer SUA_API_KEY" \
  -d '{#a5d6a7">"end_user_id": "test", "context": {"pergunta": "Olá!"}}'
4

Integre e monitore

Integre ao seu sistema (site, app, CRM, ERP) e acompanhe o consumo, custos e performance em tempo real pelo portal ou pelo endpoint de métricas.

Linguagens suportadas

A API é REST — funciona com qualquer linguagem que faça requisições HTTP. Na documentação de cada endpoint, fornecemos exemplos prontos em:

cURLPHPPythonJavaScript

Pronto para começar?

Explore os endpoints na barra lateral ou solicite suas credenciais de acesso.

Solicitar API Key