Proyecta AI Gateway

Adicione funcionalidades de IA ao seu app publicado — chatbots, geração de conteúdo, sumarização. Compatível com OpenAI. Sem necessidade de chaves de API de terceiros.

O Proyecta AI Gateway permite que os apps que você cria chamem LLMs de ponta sem que você precise criar contas em cada provedor, gerenciar suas chaves de API ou arcar com os custos. É compatível com OpenAI — aponte o SDK do OpenAI para o gateway e pronto. Atualmente, apenas os modelos Anthropic Claude estão disponíveis pelo gateway. Suporte para OpenAI, Google e Groq está no roadmap.

O que posso criar com ele?

• Chatbots — suporte ao cliente, coaching com IA, bots de FAQ
• Geração de conteúdo — descrições, e-mails, resumos, rascunhos
• Análise — extraia insights de textos, categorize dados, classifique
• Sumarização — condense documentos, artigos, transcrições
• Personalização — recomendações, UI adaptativa

Quickstart

O gateway utiliza o protocolo OpenAI Chat Completions. Use o SDK oficial do OpenAI com duas alterações — baseURL e o nome da variável de ambiente para a chave:

import OpenAI from 'openai';

const openai = new OpenAI({
    baseURL: 'https://cloud.proyecta.dev/v1/ai',
    apiKey: process.env.PROYECTA_API_KEY,
});

const response = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: 'Summarize this article in 3 bullet points: …' }],
});

Peça ao AI builder para configurar isso para você: "Add a chatbot to my app using the Proyecta AI Gateway. The user types a question and gets a streaming response."

Streaming

O streaming funciona como em qualquer client compatível com OpenAI:

const stream = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: prompt }],
    stream: true,
});

for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

Modelos

Os seguintes modelos estão disponíveis pelo gateway:

Provedor	Modelos suportados
Anthropic	claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-opus-4-8, claude-opus-4-7

Passe o ID do modelo diretamente, por exemplo, claude-haiku-4-5-20251001, claude-sonnet-4-6. Provedores adicionais estão no roadmap.

Chaves de API, limites de taxa e orçamentos

O Proyecta provisiona automaticamente uma PROYECTA_API_KEY para o seu runtime. Você não precisa criar uma manualmente para o caso comum.

Os proprietários da organização podem visualizar o uso de créditos de IA — o gasto do período atual e o limite de orçamento do plano. Isso é o que alimenta o indicador de créditos no builder.

Como é cobrado?

O uso do AI Gateway é rastreado separadamente dos créditos que o AI builder consome ao editar seu app. O custo por requisição é a tarifa do provedor subjacente, aplicada ao saldo de créditos de IA da sua organização.

FAQ

Qual é a diferença entre o AI Gateway e o AI builder?

O AI builder é o agente que escreve código no painel de chat. O AI Gateway é o que seu app publicado chama quando os seus usuários desejam uma funcionalidade de IA.

Posso usar minhas próprias chaves de provedor?

Sim — peça à IA para remover as chamadas ao gateway e configure uma integração direta com sua própria chave em Variáveis de Ambiente. Você perderá a cobrança unificada e o pool compartilhado de limites de taxa.

Posso usá-lo para geração de imagens ou voz?

Ainda não. Atualmente, o gateway é texto de entrada e texto de saída. Modalidades de imagem, voz e vídeo estão no roadmap. Para geração de imagens, consulte Geração de Imagens.

Onde posso ver o uso?

O uso de créditos é visível no nível da organização na página Settings (gasto do período atual e limite de orçamento). Um painel dedicado ao AI Gateway dentro do builder — com chaves por app e gráficos de uso em tempo real — está no roadmap.

Em breve

• Painel do Builder para o AI Gateway — crie chaves por app, defina listas de modelos permitidos, acompanhe o gasto em tempo real e gerencie chaves sem sair do builder
• Modalidades de imagem e voz — texto para imagem, texto para fala, fala para texto
• Atribuição de uso por runtime — veja quais apps da sua organização estão consumindo o quê