Proyecta AI Gateway

Agrega funciones de IA a tu app publicada — chatbots, generación de contenido, resúmenes. Compatible con OpenAI. No se requieren claves de API de terceros.

El Proyecta AI Gateway permite que las apps que construyes llamen a LLMs de frontera sin que tengas que crear cuentas con cada proveedor, gestionar sus claves de API ni absorber el costo. Es compatible con OpenAI — apunta el SDK de OpenAI al gateway y listo. Actualmente, solo los modelos Anthropic Claude están disponibles a través del gateway. El soporte para OpenAI, Google y Groq está en el roadmap.

¿Qué puedo construir con él?

• Chatbots — soporte al cliente, coaching con IA, bots de preguntas frecuentes
• Generación de contenido — descripciones, correos, resúmenes, borradores
• Análisis — extrae insights de texto, categoriza datos, clasifica información
• Resúmenes — condensa documentos, artículos, transcripciones
• Personalización — recomendaciones, UI adaptativa

Quickstart

En una app construida con Proyecta puedes llamar al gateway directamente desde tus páginas con el hook useAI() — sin manejo de claves, sin 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 una conversación de ida y vuelta usa useChat() en su lugar, que mantiene el historial de mensajes por ti.

Dos cosas que vale la pena saber, ya que un visitante anónimo gasta tus créditos: mantén los prompts acotados (no transmitas una colección completa a system) y no dispares un completion en cada pulsación de tecla.

Pídele al builder de IA que lo configure: "Add a chatbot to my app. The user types a question and gets a streaming response."

Desde tu propio backend

El gateway habla el protocolo OpenAI Chat Completions, así que desde un servidor que controles puedes apuntar el SDK oficial de OpenAI hacia él — dos cambios: baseURL y la clave:

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

El streaming funciona como cualquier cliente compatible con 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

Los siguientes modelos están disponibles a través del gateway:

Proveedor	Modelos compatibles
Anthropic	claude-sonnet-5 (insignia), claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-opus-5, claude-opus-4-8, claude-opus-4-7

Pasa el ID del modelo directamente, p. ej. claude-sonnet-5, claude-haiku-4-5-20251001. Las solicitudes para cualquier modelo fuera de esta lista son rechazadas. Proveedores adicionales están en el roadmap.

Claves de API, límites de uso y presupuestos

Proyecta aprovisiona automáticamente una PROYECTA_API_KEY para tu runtime. No necesitas crear una manualmente para el caso común.

Los propietarios de la organización pueden ver el uso de créditos de IA — el gasto del periodo actual y el límite de presupuesto de su plan. Esto es lo que alimenta el indicador de créditos en el builder.

¿Cómo se factura?

El uso del AI Gateway se rastrea de forma independiente de los créditos que consume el builder de IA cuando edita tu app. El costo por solicitud es la tarifa del proveedor subyacente, aplicada al saldo de créditos de IA de tu organización.

Preguntas frecuentes

¿Cuál es la diferencia entre el AI Gateway y el builder de IA?

El builder de IA es el agente que escribe código en el panel de chat. El AI Gateway es lo que tu app publicada llama cuando sus usuarios quieren una función de IA.

¿Puedo usar mis propias claves de proveedor?

Sí puedes — pídele a la IA que elimine las llamadas al gateway y configure una integración directa con tu propia clave en Variables de entorno. Perderás la facturación unificada y el pool compartido de límites de uso.

¿Puedo usarlo para generación de imágenes o voz?

Todavía no. Hoy el gateway es texto de entrada / texto de salida. Las modalidades de imagen, voz y video están en el roadmap. Para generación de imágenes, consulta Generación de imágenes.

¿Dónde puedo ver el uso?

El uso de créditos es visible a nivel de organización en la página Settings (gasto del periodo actual y límite de presupuesto). Un panel dedicado al AI Gateway dentro del builder — con claves por app y gráficas de uso en tiempo real — está en el roadmap.

Próximamente

• Panel del builder para AI Gateway — crea claves por app, define listas de modelos permitidos, monitorea el gasto en tiempo real y gestiona claves sin salir del builder
• Modalidades de imagen y voz — texto a imagen, texto a voz, voz a texto
• Atribución de uso por runtime — ve qué apps en tu organización están gastando y cuánto