Proyecta AI Gateway

Ajoutez des fonctionnalités IA à votre app publiée — chatbots, génération de contenu, résumé. Compatible OpenAI. Aucune clé API tierce requise.

Le Proyecta AI Gateway permet aux apps que tu construis d’appeler des LLM de pointe sans avoir à créer des comptes chez chaque fournisseur, à gérer leurs clés API ou à en avancer le coût. Il est compatible OpenAI — pointe le SDK OpenAI vers le gateway et c’est tout. Pour l’instant, seuls les modèles Anthropic Claude sont disponibles via le gateway. La prise en charge d’OpenAI, Google et Groq est prévue dans la roadmap.

Que puis-je construire avec ?

• Chatbots — support client, coaching IA, bots FAQ
• Génération de contenu — descriptions, e-mails, résumés, brouillons
• Analyse — extraire des insights depuis du texte, catégoriser des données, classifier
• Résumé — condenser des documents, articles, transcriptions
• Personnalisation — recommandations, UI adaptative

Démarrage rapide

Dans une app construite avec Proyecta, tu appelles le gateway directement depuis tes pages avec le hook useAI() — pas de gestion de clé, pas de 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>
    );
}

Pour une conversation en va-et-vient, utilise plutôt useChat(), qui conserve l’historique des messages pour toi.

Deux points à garder en tête, puisqu’un visiteur anonyme dépense tes crédits : garde les prompts bornés (n’envoie pas toute une collection en system) et n’envoie pas une complétion à chaque frappe clavier.

Demande au builder IA de le câbler : "Add a chatbot to my app. The user types a question and gets a streaming response."

Depuis ton propre backend

Le gateway parle le protocole OpenAI Chat Completions, donc depuis un serveur que tu contrôles tu peux pointer le SDK officiel OpenAI vers lui — deux changements, baseURL et la clé :

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

Le streaming fonctionne comme avec n’importe quel client compatible 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 ?? '');
}

Modèles

Les modèles suivants sont disponibles via le gateway :

Fournisseur	Modèles pris en charge
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

Passe l’identifiant du modèle directement, par ex. claude-sonnet-5, claude-haiku-4-5-20251001. Les requêtes pour tout modèle absent de cette liste sont rejetées. Des fournisseurs supplémentaires sont prévus dans la roadmap.

Clés API, limites de débit et budgets

Proyecta provisionne automatiquement une PROYECTA_API_KEY pour ton environnement d’exécution. Tu n’as pas besoin d’en créer une manuellement dans le cas courant.

Les propriétaires d’organisation peuvent consulter la consommation de crédits IA — les dépenses de la période en cours et le plafond budgétaire de leur plan. C’est ce qui alimente l’indicateur de crédits dans le builder.

Comment est-ce facturé ?

L’utilisation du AI Gateway est suivie séparément des crédits que le builder IA consomme lorsqu’il modifie ton app. Le coût par requête correspond au tarif du fournisseur sous-jacent, appliqué au solde de crédits IA de ton organisation.

FAQ

Quelle est la différence entre le AI Gateway et le builder IA ?

Le builder IA est l’agent qui écrit du code dans le panneau de chat. Le AI Gateway est ce que ton app publiée appelle lorsque ses utilisateurs souhaitent une fonctionnalité IA.

Puis-je utiliser mes propres clés fournisseur ?

Oui — demande à l’IA de supprimer les appels au gateway et de configurer une intégration directe avec ta propre clé dans Variables d’environnement. Tu perdras la facturation unifiée et le pool de limites de débit partagé.

Puis-je l’utiliser pour la génération d’images ou de voix ?

Pas encore. Aujourd’hui, le gateway est texte en entrée / texte en sortie. Les modalités image, voix et vidéo sont prévues dans la roadmap. Pour la génération d’images, consulte Génération d’images.

Où puis-je consulter la consommation ?

La consommation de crédits est visible au niveau de l’organisation dans la page Settings (dépenses de la période en cours et plafond budgétaire). Un panneau AI Gateway dédié dans le builder — avec des clés par app et des graphiques de consommation en direct — est prévu dans la roadmap.

Prochainement

• Panneau builder pour le AI Gateway — créer des clés par app, définir des listes de modèles autorisés, surveiller les dépenses en direct et gérer les clés sans quitter le builder
• Modalités image et voix — texte vers image, texte vers parole, parole vers texte
• Attribution de la consommation par environnement d’exécution — voir quelles apps de ton organisation dépensent quoi