Aller au contenu

Pour les développeurs

Un seul hub IA pour toutes vos applications.

Vos applications appellent nerix plutôt que chaque fournisseur d’IA. Une clé par serveur, 63 modèles dans un même format, un seul solde de crédits, et chaque réponse indique le modèle utilisé et son coût.

SDKPHPNodePythonGo

example.ts
// one client per process: it holds your server's key
import { RespireSoftAI } from '@respiresoft/ai'

const ai = new RespireSoftAI()

const answer = await ai.chat.create({
  model: 'mistral/mistral-large-latest',  // or an alias: 'fast'
  messages: [{ role: 'user', content: 'Summarise this contract' }],
  nerix: { tenant: 't42', feature: 'summaries' },
})

answer.nerix.resolved   // the model that actually answered
answer.nerix.cost       // { credits: 2, ... }
Fig. 1 Le même appel depuis Node. La syntaxe est similaire en PHP, Python et Go.

01Fonctionnement

Trois étapes, dont la première reste entièrement sur votre serveur.

  1. 01

    Créez une clé sur votre serveur

    Une seule commande crée une clé privée que seul votre serveur peut lire, et affiche sa partie publique.

    $ npx respiresoft-ai keygen --out /srv/keys/myapp-ai.pem

    Sur votre serveur : la clé privée est enregistrée avec des permissions réservées à son propriétaire et n’est jamais affichée.

  2. 02

    Envoyez-nous la partie publique

    Nous enregistrons votre application, ses périmètres d’accès, ses limites et son tarif en crédits.

  3. 03

    Appelez le hub

    Avec le SDK pour PHP, Node, Python ou Go, ou tout client capable de signer une requête.

    $ npx respiresoft-ai doctor

    Vérifie l’adresse, votre clé, les clés du hub, l’horloge et la signature du hub avant votre premier appel.

02Fonctionnalités disponibles

Discussion, recherche, images et voix dès aujourd’hui. Les agents suivront.

Toutes les fonctionnalités ci-dessous passent par le même point d’accès avec signature, sont facturées avec les mêmes crédits et indiquent le modèle qui a effectué le travail.

  • Accès anticipé

    Conversation et streaming

    Tous les modèles de conversation, avec des réponses jeton par jeton et la prise en charge des outils.

  • Accès anticipé

    Choix automatique du modèle

    Envoyez le nom de modèle "auto" et le hub choisit le modèle et le niveau d’effort selon des règles fixes, en moins de 5 ms.

  • Accès anticipé

    Embeddings et recherche

    Des vecteurs issus de n’importe quel modèle d’embedding, et des collections de recherche partagées, cloisonnées par application et par client.

  • Accès anticipé

    Images

    Des images générées à partir d’une description écrite, avec les modèles OpenAI et Google.

  • Accès anticipé

    Voix en temps réel

    Des jetons à courte durée de validité permettent à un téléphone ou à un navigateur de transmettre la voix en continu directement au fournisseur vocal.

  • Accès anticipé

    Moins cher si cela peut attendre

    Indiquez qu’une tâche peut attendre pour qu’elle soit exécutée au tarif réduit du fournisseur.

  • Accès anticipé

    Agents, outils et documents numérisés

    Des exécutions avec utilisation d’outils, lecture de pages numérisées et validations.

  • Accès anticipé

    Tâches planifiées

    Des flux de travail qui s’exécutent selon un calendrier ou après validation par une personne.

03Sécurité

Requêtes signées, réponses signées, aucun secret à divulguer.

  • Votre clé ne quitte jamais votre serveur

    Chaque serveur génère sa propre clé Ed25519. Le hub ne conserve que la partie publique, et deux clés peuvent coexister pendant leur renouvellement.

  • Chaque requête est signée

    La méthode, le chemin, les paramètres de requête et une empreinte du corps sont signés selon la norme de signature des messages HTTP (RFC 9421). Toute requête datant de plus de 60 secondes ou déjà reçue est refusée.

  • Chaque réponse est signée

    Les réponses et les flux sont signés par le hub et vérifiés par le SDK à l’aide de clés épinglées. Si une vérification échoue, le SDK refuse la réponse.

  • Principe du moindre privilège

    Périmètres d’autorisation, limites de débit, de jetons et de crédits par clé, par client et par fonctionnalité. Les identifiants clients sont opaques : jamais une adresse e-mail ni un nom.

04Crédits

Une seule monnaie pour toutes les applications et tous les modèles.

  • Réservés, puis débités

    Les crédits sont réservés avant l’appel, puis débités après, au coût réel du travail effectué par le modèle.

  • Un tarif par application

    Chaque application dispose de son propre tarif, défini lors de son enregistrement, afin que chaque produit puisse appliquer une tarification différente à l’IA.

  • Une consommation que vous pouvez expliquer

    Chaque réponse indique sa consommation (jetons d’entrée, d’entrée en cache, de sortie et de raisonnement) ainsi que son coût.

Pour le moment, l’accès se fait sur inscription : envoyez-nous le nom de votre application et la partie publique de sa clé.

Contactez-nous