Proyecta AI Gateway

Adaugă funcționalități AI în aplicația ta publicată — chatboți, generare de conținut, rezumare. Compatibil OpenAI. Nu sunt necesare chei API de la terți.

Proyecta AI Gateway permite aplicațiilor pe care le construiești să apeleze LLM-uri de ultimă generație fără să fie nevoie să îți creezi conturi la fiecare furnizor, să gestionezi cheile lor API sau să suporți costurile în avans. Este compatibil cu OpenAI — pointează SDK-ul OpenAI spre gateway și ești gata. Momentan, prin gateway sunt disponibile doar modelele Anthropic Claude. Suportul pentru OpenAI, Google și Groq este pe roadmap.

Ce pot construi cu el?

• Chatboți — suport pentru clienți, coaching AI, boți de FAQ
• Generare de conținut — descrieri, emailuri, rezumate, schițe
• Analiză — extrage insight-uri din text, categorizează date, clasifică
• Rezumare — condensează documente, articole, transcrieri
• Personalizare — recomandări, interfață adaptivă

Quickstart

Într-o aplicație construită cu Proyecta, apelezi gateway-ul direct din paginile tale cu hook-ul useAI() — fără gestionarea cheilor, fără 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>
    );
}

Pentru o conversație dus-întors, folosește useChat() în schimb, care păstrează istoricul mesajelor pentru tine.

Două lucruri de reținut, deoarece un vizitator anonim consumă creditele tale: ține prompt-urile delimitate (nu încărca o întreagă colecție în system) și nu declanșa un completion la fiecare apăsare de tastă.

Cere builder-ului AI să configureze totul: "Add a chatbot to my app. The user types a question and gets a streaming response."

Din propriul tău backend

Gateway-ul vorbește protocolul OpenAI Chat Completions, deci de pe un server pe care îl controlezi poți pointa SDK-ul oficial OpenAI spre el — două modificări, baseURL și cheia:

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

Streaming-ul funcționează ca orice client compatibil 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 ?? '');
}

Modele

Următoarele modele sunt disponibile prin gateway:

Furnizor	Modele acceptate
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

Transmite ID-ul modelului direct, de ex. claude-sonnet-5, claude-haiku-4-5-20251001. Cererile pentru orice model din afara acestei liste sunt respinse. Furnizori suplimentari sunt pe roadmap.

Chei API, limite de rată și bugete

Proyecta provisionează automat un PROYECTA_API_KEY pentru runtime-ul tău. Nu trebuie să creezi unul manual pentru cazul obișnuit.

Proprietarii de organizație pot vedea utilizarea creditelor AI — cheltuielile din perioada curentă și limita bugetară a planului lor. Aceasta este ceea ce alimentează indicatorul de credite din builder.

Cum se facturează?

Utilizarea AI Gateway este urmărită separat de creditele pe care le consumă builder-ul AI atunci când îți editează aplicația. Costul per cerere reprezintă tariful furnizorului de bază, aplicat soldului de credite AI al organizației tale.

Întrebări frecvente

Care este diferența dintre AI Gateway și builder-ul AI?

Builder-ul AI este agentul care scrie cod în panoul de chat. AI Gateway este ceea ce apelează aplicația ta publicată atunci când utilizatorii săi doresc o funcționalitate AI.

Pot folosi propriile mele chei de furnizor?

Poți — cere AI-ului să elimine apelurile gateway și să configureze o integrare directă cu propria ta cheie în Variabile de Mediu. Vei pierde facturarea unificată și pool-ul partajat de limite de rată.

Pot să îl folosesc pentru generare de imagini sau voce?

Nu încă. Momentan, gateway-ul este text-in / text-out. Modalitățile pentru imagini, voce și video sunt pe roadmap. Pentru generare de imagini, vezi Generare de Imagini.

Unde pot vedea utilizarea?

Utilizarea creditelor este vizibilă la nivel de organizație în pagina Settings (cheltuielile din perioada curentă și limita bugetară). Un panou dedicat AI Gateway în interiorul builder-ului — cu chei per aplicație și grafice de utilizare în timp real — este pe roadmap.

În curând

• Panou Builder pentru AI Gateway — creează chei per aplicație, setează liste de modele permise, urmărește cheltuielile în timp real și gestionează cheile fără să părăsești builder-ul
• Modalități pentru imagini și voce — text-to-image, text-to-speech, speech-to-text
• Atribuirea utilizării per runtime — vezi care aplicații din organizația ta cheltuiesc cât