Construa com uma inteligência que entrega.

Primeiros passos

Crie uma chave em Configurações → API e integrações. A chave completa é exibida uma única vez. Armazene-a em um gerenciador de segredos e nunca no navegador ou repositório.

curl https://ai.aemsolucoes.com/api/v1/chat/completions \
+  -H "Authorization: Bearer $AEM_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
    "model": "aem-auto",
    "messages": [{"role":"user","content":"Crie um resumo executivo."}]
  }'

Plataforma AEM

API REST v1

A API v1 utiliza JSON sobre HTTPS e vive sob https://ai.aemsolucoes.com/api/v1. A primeira versão pública oferece saúde, catálogo lógico de modelos e Chat Completions. Novos recursos serão adicionados de maneira compatível.

Autenticação e chaves

Envie a chave no cabeçalho Bearer. Chaves começam com aem_live_, são armazenadas somente como hash e podem ser revogadas imediatamente. Escopos iniciais: chat:write e models:read.

Authorization: Bearer aem_live_••••••••••••••••••••

• Uma chave por aplicação e ambiente.
• Rotacione chaves periodicamente.
• Nunca envie chaves em query strings.
• Revogue imediatamente em caso de exposição.

Chat Completions

O contrato segue o formato conhecido de mensagens com papéis system, user e assistant. A resposta contém identificador rastreável no corpo e em x-request-id.

const response = await fetch("https://ai.aemsolucoes.com/api/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AEM_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "aem-auto",
    messages: [
      { role: "system", content: "Responda como analista executivo." },
      { role: "user", content: "Resuma os principais riscos do projeto." },
    ],
  }),
});
const data = await response.json();
console.log(data.choices[0].message.content);

Modelos lógicos

Integração MCP

A AEM também publica um servidor MCP para clientes e agentes compatíveis. O MCP permite descobrir ferramentas e acioná-las de forma semântica, preservando autenticação e políticas da plataforma.

Endpoint MCP: https://ai.aemsolucoes.com/mcp
Descoberta:  https://ai.aemsolucoes.com/.mcp/list-tools
OAuth:       https://ai.aemsolucoes.com/.well-known/oauth-protected-resource

Erros, repetição e resiliência

Erros seguem um envelope estável com type, code e message. Em 429 e 503, use repetição com atraso exponencial e jitter. Operações POST aceitam Idempotency-Key: repita a mesma chave e o mesmo corpo para receber a resposta original sem executar novamente. As chaves permanecem válidas por 24 horas.

Idempotency-Key: pedido-123-tentativa-1

{
  "error": {
    "type": "aem_api_error",
    "code": "temporarily_unavailable",
    "message": "A inteligência está temporariamente indisponível."
  }
}

Segurança e produção

Changelog e compatibilidade

Suporte para integrações