Proyecta AI Gateway

Dodaj funkcje AI do swojej opublikowanej aplikacji — chatboty, generowanie treści, podsumowania. Kompatybilny z OpenAI. Bez kluczy API firm trzecich.

Proyecta AI Gateway pozwala aplikacjom, które tworzysz, wywoływać czołowe modele LLM bez konieczności zakładania kont u poszczególnych dostawców, zarządzania ich kluczami API ani ponoszenia kosztów z góry. Jest kompatybilny z OpenAI — wystarczy skierować OpenAI SDK na gateway i gotowe. Obecnie przez gateway dostępne są wyłącznie modele Anthropic Claude. Obsługa OpenAI, Google i Groq jest w planach.

Co mogę z nim zbudować?

• Chatboty — obsługa klienta, coaching AI, boty FAQ
• Generowanie treści — opisy, e-maile, podsumowania, szkice
• Analiza — wyciąganie wniosków z tekstu, kategoryzowanie danych, klasyfikacja
• Podsumowania — skracanie dokumentów, artykułów, transkryptów
• Personalizacja — rekomendacje, adaptacyjny UI

Quickstart

W aplikacji zbudowanej przez Proyecta możesz wywoływać gateway bezpośrednio ze swoich stron za pomocą hooka useAI() — bez obsługi kluczy, bez backendu:

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>
    );
}

Do prowadzenia konwersacji użyj zamiast tego useChat(), który automatycznie przechowuje historię wiadomości.

Dwie rzeczy warte uwagi, ponieważ anonimowy użytkownik zużywa Twoje kredyty: ogranicz rozmiar promptów (nie przesyłaj całej kolekcji do system) i nie wysyłaj zapytania do modelu przy każdym naciśnięciu klawisza.

Poproś budowniczego AI o konfigurację: "Add a chatbot to my app. The user types a question and gets a streaming response."

Z własnego backendu

Gateway obsługuje protokół OpenAI Chat Completions, więc z serwera, którym zarządzasz, możesz skierować oficjalne OpenAI SDK na gateway — wystarczą dwie zmiany: baseURL i klucz:

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 działa jak w każdym kliencie kompatybilnym z 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

Przez gateway dostępne są następujące modele:

Dostawca	Obsługiwane modele
Anthropic	claude-sonnet-5 (flagowy), claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-opus-5, claude-opus-4-8, claude-opus-4-7

Podaj identyfikator modelu bezpośrednio, np. claude-sonnet-5, claude-haiku-4-5-20251001. Żądania dotyczące modeli spoza tej listy są odrzucane. Dodatkowi dostawcy są w planach.

Klucze API, limity i budżety

Proyecta automatycznie przypisuje PROYECTA_API_KEY do Twojego środowiska uruchomieniowego. W typowym przypadku nie musisz tworzyć go ręcznie.

Właściciele organizacji mogą sprawdzać zużycie kredytów AI — wydatki w bieżącym okresie oraz limit budżetu przypisany do ich planu. To właśnie zasila wskaźnik kredytów w builderze.

Jak działa rozliczanie?

Użycie AI Gateway jest rozliczane oddzielnie od kredytów zużywanych przez budowniczego AI podczas edytowania aplikacji. Koszt pojedynczego żądania odpowiada stawce bazowej danego dostawcy i jest odejmowany od salda kredytów AI Twojej organizacji.

FAQ

Jaka jest różnica między AI Gateway a budowniczym AI?

Budowniczy AI to agent piszący kod w panelu czatu. AI Gateway to usługa, którą Twoja opublikowana aplikacja wywołuje, gdy jej użytkownicy chcą skorzystać z funkcji AI.

Czy mogę używać własnych kluczy dostawcy?

Tak — poproś AI o usunięcie wywołań gateway i skonfiguruj bezpośrednią integrację z własnym kluczem w Zmiennych środowiskowych. Stracisz wtedy ujednolicone rozliczanie i wspólną pulę limitów.

Czy mogę używać go do generowania obrazów lub głosu?

Jeszcze nie. Obecnie gateway obsługuje wyłącznie tekst na wejściu i wyjściu. Modalności obrazu, głosu i wideo są w planach. W kwestii generowania obrazów zajrzyj do Generowania obrazów.

Gdzie mogę sprawdzić zużycie?

Zużycie kredytów jest widoczne na poziomie organizacji na stronie Settings (wydatki w bieżącym okresie i limit budżetu). Dedykowany panel AI Gateway w builderze — z kluczami per aplikacja i wykresami zużycia na żywo — jest w planach.

Wkrótce

• Panel budowniczego dla AI Gateway — twórz klucze per aplikacja, ustawiaj listy dozwolonych modeli, obserwuj wydatki na żywo i zarządzaj kluczami bez wychodzenia z buildera
• Modalności obrazu i głosu — text-to-image, text-to-speech, speech-to-text
• Przypisywanie zużycia do środowisk uruchomieniowych — sprawdzaj, które aplikacje w Twojej organizacji ile wydają