Introduction

@fleeex/sdk est une fine surcouche du SDK OpenAI pour le proxy LLM Fleeex : connexion préconfigurée, aides à la facturation, et aucune perte de compatibilité OpenAI.

@fleeex/sdk est le client officiel de Fleeex, un portefeuille prépayé centralisé pour l'usage de l'IA, doublé d'un proxy LLM compatible OpenAI. Le SDK est une fine surcouche du SDK OpenAI : il préconfigure l'URL de base, votre clé d'API et l'en-tête x-fleeex-user, et ajoute quelques aides à la facturation. Deux lignes suffisent pour démarrer, et rien n'est abandonné de la compatibilité OpenAI.

import { FleeexClient } from "@fleeex/sdk";
 
const client = new FleeexClient({
  apiKey: process.env.FLEEEX_API_KEY!, // flx_…, un secret côté serveur
  userId: "user-123", // l'utilisateur final dont votre app se porte garante
});
 
const completion = await client.chat.completions.create({
  model: "nova-lite",
  messages: [{ role: "user", content: "Bonjour !" }],
});

client.chat.completions.create est la méthode OpenAI, avec les types de requête et de réponse d'OpenAI. Le SDK se contente de préconfigurer la connexion et de traduire le 402. Ce que le serveur accepte à l'intérieur de cette requête est plus étroit : le protocole est iso-OpenAI, la surface de paramètres en est un sous-ensemble documenté, et un paramètre non pris en charge revient en 400 qui le nomme, plutôt qu'en champ silencieusement ignoré. Voir Paramètres pris en charge.

Pourquoi l'utiliser

• Deux lignes de configuration. Vous visez Fleeex sans câbler vous-même l'URL de base, la clé bearer et l'en-tête par utilisateur.
• La facturation est incluse. getBalance(), getUsageSummary() et un 402 typé porteur d'un lien de rechargement, soit des données que le SDK OpenAI brut n'expose pas.
• Aucun verrouillage. Le protocole reste iso-OpenAI : vous pouvez revenir au SDK OpenAI brut à tout moment (un test de non-régression vérifie que les requêtes sont identiques octet pour octet). Voir Revenir au SDK OpenAI brut.

Côté serveur uniquement. La clé d'API est un secret serveur : ne l'embarquez jamais dans un navigateur ni dans un client mobile. Voir Authentification.

Par où continuer

• Installation : ajoutez le SDK à votre projet.
• Démarrage rapide : votre premier appel compté.
• Choisir un modèle : passez un alias, et demandez quels modèles votre app peut appeler. À lire avant le premier appel.
• Paramètres pris en charge : ce que le proxy honore, accepte sans effet, et refuse. À lire en deuxième.
• Bac à sable : intégrez, et provoquez chaque refus, sans payer un centime.
• Appeler le modèle : streaming et son chunk d'usage, appel de fonctions, sortie structurée, vision.
• Argent et onboarding : solde et paiements, connecter vos utilisateurs, usage, et webhooks pour être prévenu avant qu'un utilisateur soit coupé.
• Référence API : chaque option, méthode, type et erreur.

Fleeex, c'est quoi ?

Un seul solde prépayé finance l'usage de l'IA dans toutes les applications qui intègrent Fleeex, et la consommation est comptée par application et par utilisateur final : chacun paie son propre usage de l'IA, en toute transparence. Plus d'informations sur fleeex.app.