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 costruisci 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 verso il gateway e il gioco è fatto. Al momento, tramite il gateway sono disponibili solo i modelli Anthropic Claude. Il supporto per OpenAI, Google e Groq è in programma.

Cosa posso costruire con esso?

• Chatbot — supporto clienti, coaching 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

Il gateway utilizza il protocollo OpenAI Chat Completions. Usa l’SDK ufficiale di OpenAI con due modifiche — baseURL e il nome della variabile d’ambiente per 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: …' }],
});

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

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-4-6, claude-haiku-4-5-20251001, claude-opus-4-8, claude-opus-4-7

Passa l’ID del modello direttamente, ad es. claude-haiku-4-5-20251001, claude-sonnet-4-6. Ulteriori provider sono in programma.

Chiavi API, limiti di frequenza 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 il builder AI consuma quando modifica la tua app. Il costo per singola richiesta corrisponde alla tariffa del provider sottostante, applicata al saldo dei crediti AI della tua organizzazione.

FAQ

Qual è la differenza tra il AI Gateway e il builder AI?

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

Posso usare le chiavi del mio provider?

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

Posso usarlo per la generazione di immagini o audio?

Non ancora. Al momento il gateway è solo testo in ingresso / testo in uscita. Le modalità per immagini, audio e video sono in programma. Per la generazione di immagini, consulta Generazione di Immagini.

Dove posso visualizzare 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 al AI Gateway all’interno del builder — con chiavi per singola app e grafici di utilizzo in tempo reale — è in programma.

Prossimamente

• Pannello del builder per il 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à per immagini 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