AI Gateway

1. Em AI, em Chaves dos provedores, cole a chave da sua conta em cada provedor que for usar (OpenAI, Anthropic, Google, Groq, Mistral, DeepSeek, OpenRouter, xAI) e Conferir e salvar. O provedor cobra a sua conta direto.
2. Em Chaves do gateway, Criar chave. Escolhendo um projeto, CLAUDO_AI_URL e CLAUDO_AI_KEY vão para Production.

import OpenAI from "openai";

const ai = new OpenAI({
  baseURL: `${process.env.CLAUDO_AI_URL}/v1`,
  apiKey: process.env.CLAUDO_AI_KEY,
});

const resposta = await ai.chat.completions.create({
  model: "openai/<modelo>",
  messages: [{ role: "user", content: "Olá" }],
});

import Anthropic from "@anthropic-ai/sdk";

const claude = new Anthropic({
  baseURL: process.env.CLAUDO_AI_URL,
  apiKey: process.env.CLAUDO_AI_KEY,
});

No formato OpenAI, o modelo vai como provedor/modelo: openai/, google/, groq/, mistral/, deepseek/, openrouter/ ou xai/. Claude usa o formato da Anthropic (/v1/messages). Só no servidor: a chave não funciona do navegador.

• Modelos de reserva: cabeçalho x-claudo-fallback: groq/<modelo>,google/<modelo> (até 3). Tenta o próximo em erro de rede, 429 ou 5xx; a resposta diz qual respondeu em x-claudo-model.
• Cache de respostas: x-claudo-cache-ttl: 3600 guarda a resposta igual por até esse tanto de segundos (sem streaming). x-claudo-cache: hit indica resposta do cache.
• Orçamento do mês em reais, com e-mail a 80% e 100% e bloqueio (429) ao chegar. O custo é estimado pela tabela de preços e pelo dólar do Banco Central.
• Chamadas no mês: Free 1.000, Pro 100.000, Scale 1.000.000.