Proyecta AI Gateway

Adicione recursos 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 da OpenAI para o gateway e pronto. Atualmente, apenas os modelos Anthropic Claude estão disponíveis pelo gateway. Suporte a 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 texto, categorize dados, classifique
• Sumarização — condense documentos, artigos, transcrições
• Personalização — recomendações, UI adaptativa

Quickstart

Em um app criado com Proyecta, você chama o gateway diretamente das suas páginas com o hook useAI() — sem gerenciamento de chaves, sem backend:

import { useAI } from '@/hooks/useAI.ts';

function Summarizer({ article }) {
    const { ask, isPending, error } = useAI({ system: 'You summarize articles.' });
    const [summary, setSummary] = useState('');

    return (
        <button
            disabled={isPending}
            onClick={async () => setSummary(await ask(`Summarize in 3 bullets: ${article}`))}
        >
            Summarize
        </button>
    );
}

Para uma conversa de ida e volta, use useChat() no lugar, que mantém o histórico de mensagens para você.

Dois pontos importantes a considerar, já que um visitante anônimo consome seus créditos: mantenha os prompts delimitados (não envie uma coleção inteira para o system) e não dispare uma completion a cada tecla pressionada.

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

A partir do seu próprio backend

O gateway fala o protocolo OpenAI Chat Completions, então a partir de um servidor que você controla, você pode apontar o SDK oficial da OpenAI para ele — duas mudanças, baseURL e 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: …' }],
});

Streaming

O streaming funciona como qualquer cliente 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-5 (flagship), claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-opus-5, claude-opus-4-8, claude-opus-4-7

Passe o ID do modelo diretamente, por exemplo claude-sonnet-5, claude-haiku-4-5-20251001. Requisições para qualquer modelo fora desta lista são rejeitadas. 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 no caso comum.

Os proprietários da organização podem ver o uso de créditos de IA — gasto no 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 seus usuários querem um recurso de IA.

Posso usar minhas próprias chaves de provedor?

Pode — 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 usar para geração de imagens ou voz?

Ainda não. Hoje o gateway é texto-para-texto. 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 no 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 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 — text-to-image, text-to-speech, speech-to-text
• Atribuição de uso por runtime — veja quais apps da sua organização estão gastando o quê