Proyecta AI Gateway

Aggiungi funzionalità AI alla tua app pubblicata — chatbot, generazione di contenuti, riassunti. Compatibile con OpenAI. Nessuna chiave API di terze parti richiesta.

Il Proyecta AI Gateway consente alle app che crei di chiamare LLM di frontiera senza dover creare account presso ciascun provider, gestire le relative chiavi API o anticipare i costi. È compatibile con OpenAI — punta l’SDK di OpenAI al gateway e il gioco è fatto. Al momento, attraverso il gateway sono disponibili solo i modelli Anthropic Claude. Il supporto per OpenAI, Google e Groq è previsto nella roadmap.

Cosa posso costruire con esso?

• Chatbot — assistenza clienti, coaching con AI, bot per le FAQ
• Generazione di contenuti — descrizioni, email, riassunti, bozze
• Analisi — estrai insight dal testo, categorizza dati, classifica
• Riassunti — sintetizza documenti, articoli, trascrizioni
• Personalizzazione — raccomandazioni, UI adattiva

Quickstart

In un’app costruita con Proyecta puoi chiamare il gateway direttamente dalle tue pagine con il hook useAI() — nessuna gestione di chiavi, nessun 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>
    );
}

Per una conversazione bidirezionale usa invece useChat(), che mantiene per te la cronologia dei messaggi.

Due cose da tenere a mente, poiché un visitatore anonimo consuma i tuoi crediti: mantieni i prompt delimitati (non passare un’intera collezione a system) e non inviare una completion a ogni pressione di tasto.

Chiedi all’AI builder di configurarlo: "Add a chatbot to my app. The user types a question and gets a streaming response."

Dal tuo backend

Il gateway parla il protocollo OpenAI Chat Completions, quindi da un server che controlli puoi puntare l’SDK ufficiale di OpenAI verso di esso — bastano due modifiche, baseURL e la chiave:

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

Lo streaming funziona come con qualsiasi client compatibile 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 ?? '');
}

Modelli

I seguenti modelli sono disponibili tramite il gateway:

Provider	Modelli supportati
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

Passa l’ID del modello direttamente, ad esempio claude-sonnet-5, claude-haiku-4-5-20251001. Le richieste per qualsiasi modello al di fuori di questo elenco vengono rifiutate. Provider aggiuntivi sono previsti nella roadmap.

Chiavi API, limiti di velocità e budget

Proyecta fornisce automaticamente una PROYECTA_API_KEY per il tuo runtime. Non è necessario crearne una manualmente per il caso d’uso comune.

I proprietari dell’organizzazione possono visualizzare l’utilizzo dei crediti AI — la spesa del periodo corrente e il limite di budget del piano. Questo è ciò che alimenta l’indicatore dei crediti nel builder.

Come viene fatturato?

L’utilizzo del AI Gateway viene tracciato separatamente dai crediti che l’AI builder consuma quando modifica la tua app. Il costo per richiesta è la tariffa del provider sottostante, applicata al saldo dei crediti AI della tua organizzazione.

FAQ

Qual è la differenza tra l’AI Gateway e l’AI builder?

L’AI builder è l’agente che scrive codice nel pannello chat. L’AI Gateway è ciò che la tua app pubblicata chiama quando i suoi utenti desiderano una funzionalità AI.

Posso usare le mie chiavi provider?

Puoi farlo — chiedi all’AI di rimuovere le chiamate al gateway e configura un’integrazione diretta con la tua chiave nelle Variabili d’Ambiente. Perderai la fatturazione unificata e il pool condiviso dei limiti di velocità.

Posso usarlo per la generazione di immagini o audio?

Non ancora. Al momento il gateway è solo testo-in / testo-out. Le modalità immagine, audio e video sono previste nella roadmap. Per la generazione di immagini, consulta Generazione di Immagini.

Dove posso vedere l’utilizzo?

L’utilizzo dei crediti è visibile a livello di organizzazione nella pagina Settings (spesa del periodo corrente e limite di budget). Un pannello dedicato all’AI Gateway all’interno del builder — con chiavi per singola app e grafici di utilizzo in tempo reale — è previsto nella roadmap.

Prossimamente

• Pannello builder per l’AI Gateway — crea chiavi per singola app, imposta allowlist di modelli, monitora la spesa in tempo reale e gestisci le chiavi senza mai lasciare il builder
• Modalità immagine e audio — text-to-image, text-to-speech, speech-to-text
• Attribuzione dell’utilizzo per runtime — scopri quali app della tua organizzazione stanno spendendo e quanto