Proyecta AI Gateway

Füge deiner veröffentlichten App KI-Funktionen hinzu – Chatbots, Content-Generierung, Zusammenfassungen. OpenAI-kompatibel. Keine Drittanbieter-API-Schlüssel erforderlich.

Mit dem Proyecta AI Gateway können die Apps, die du baust, frontier-LLMs aufrufen, ohne dass du Konten bei jedem Anbieter erstellen, deren API-Schlüssel verwalten oder die Kosten vorstrecken musst. Er ist OpenAI-kompatibel – richte das OpenAI SDK auf das Gateway aus, und du bist fertig. Derzeit sind über das Gateway nur Anthropic-Claude-Modelle verfügbar. Unterstützung für OpenAI, Google und Groq ist auf der Roadmap.

Was kann ich damit bauen?

• Chatbots — Kundensupport, KI-Coaching, FAQ-Bots
• Content-Generierung — Beschreibungen, E-Mails, Zusammenfassungen, Entwürfe
• Analyse — Erkenntnisse aus Text gewinnen, Daten kategorisieren, klassifizieren
• Zusammenfassungen — Dokumente, Artikel und Transkripte verdichten
• Personalisierung — Empfehlungen, adaptive UI

Quickstart

In einer mit Proyecta erstellten App rufst du das Gateway direkt aus deinen Seiten mit dem useAI()-Hook auf – kein Schlüssel-Handling, kein 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>
    );
}

Für ein Hin-und-Her-Gespräch verwende stattdessen useChat(), das den Nachrichtenverlauf für dich verwaltet.

Zwei Dinge sind wichtig zu wissen, da ein anonymer Besucher deine Credits verbraucht: Halte Prompts begrenzt (streame nicht eine ganze Collection in system), und löse keinen Completion-Aufruf bei jedem Tastendruck aus.

Bitte den AI Builder, es einzurichten: "Add a chatbot to my app. The user types a question and gets a streaming response."

Von deinem eigenen backend

Das Gateway spricht das OpenAI-Chat-Completions-Protokoll. Von einem Server, den du kontrollierst, kannst du das offizielle OpenAI SDK darauf ausrichten – zwei Änderungen: baseURL und der Schlüssel:

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 funktioniert wie bei jedem OpenAI-kompatiblen Client:

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

Modelle

Folgende Modelle sind über das Gateway verfügbar:

Anbieter	Unterstützte Modelle
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

Übergib die Modell-ID direkt, z. B. claude-sonnet-5, claude-haiku-4-5-20251001. Anfragen für Modelle außerhalb dieser Liste werden abgelehnt. Weitere Anbieter sind auf der Roadmap.

API-Schlüssel, Rate Limits und Budgets

Proyecta stellt automatisch einen PROYECTA_API_KEY für deine Runtime bereit. Für den Standardfall musst du keinen manuell erstellen.

Organisationsinhaber können die Nutzung der KI-Credits einsehen – den Verbrauch im aktuellen Zeitraum und das Budget-Limit ihres Plans. Das ist die Grundlage für die Credits-Anzeige im Builder.

Wie wird abgerechnet?

Die Nutzung des AI Gateways wird getrennt von den Credits erfasst, die der AI Builder beim Bearbeiten deiner App verbraucht. Die Kosten pro Anfrage entsprechen dem Tarif des jeweiligen Anbieters und werden dem KI-Credits-Guthaben deiner Organisation belastet.

FAQ

Was ist der Unterschied zwischen dem AI Gateway und dem AI Builder?

Der AI Builder ist der Agent, der Code im Chat-Panel schreibt. Das AI Gateway ist das, was deine veröffentlichte App aufruft, wenn ihre Nutzer eine KI-Funktion verwenden möchten.

Kann ich meine eigenen Anbieter-Schlüssel verwenden?

Ja – bitte die KI, die Gateway-Aufrufe zu entfernen, und konfiguriere eine direkte Integration mit deinem eigenen Schlüssel unter Umgebungsvariablen. Du verlierst dabei die einheitliche Abrechnung und den gemeinsamen Rate-Limit-Pool.

Kann ich es für Bild- oder Sprachgenerierung nutzen?

Noch nicht. Derzeit ist das Gateway auf Text-Eingabe und Text-Ausgabe beschränkt. Bild-, Sprach- und Videomodalitäten sind auf der Roadmap. Für die Bildgenerierung siehe Bildgenerierung.

Wo kann ich die Nutzung einsehen?

Die Credits-Nutzung ist auf Organisationsebene auf der Settings-Seite sichtbar (Verbrauch im aktuellen Zeitraum und Budget-Limit). Ein dediziertes AI-Gateway-Panel im Builder – mit App-spezifischen Schlüsseln und Live-Nutzungsdiagrammen – ist auf der Roadmap.

Demnächst verfügbar

• Builder-Panel für AI Gateway — App-spezifische Schlüssel erstellen, Modell-Allowlists festlegen, Live-Verbrauch beobachten und Schlüssel verwalten, ohne den Builder zu verlassen
• Bild- und Sprachmodalitäten — Text-zu-Bild, Text-zu-Sprache, Sprache-zu-Text
• Nutzungszuordnung pro Runtime — sehen, welche Apps in deiner Organisation wie viel verbrauchen