IaGenify SDK Alpha : un seul client, partout où votre code s’exécute.

Le SDK IaGenify est né comme une fine couche HTTP autour de notre API. Dans sa version alpha, il est devenu l’outil avec lequel nous construisons nos propres produits : un client JavaScript unique, identique sous Node.js, dans le navigateur et sur Cloudflare Workers, qui masque l’authentification, les sessions et les garde-fous de facturation derrière une petite interface orientée objet.

Ceci n’est pas un manuel de référence. C’est une visite rapide des idées sur lesquelles nous misons, avec quelques extraits dans la syntaxe que vous utiliserez réellement et un aperçu de la direction prise par le SDK.

Un seul client, partout où votre code s’exécute

Le client détecte son environnement au démarrage. Il gère l’authentification, les sessions et les garde-fous de facturation afin que votre application puisse se concentrer sur sa tâche.

import { IaGenify } from "iagenify";

const api = new IaGenify({
  apiKey: process.env.IAGENIFY_API_KEY,
  appName: "release-notes-bot",
});

Sous Node.js, le SDK conserve sa session dans un fichier privé sous ~/.iagenify/ ; dans le navigateur, il utilise localStorage ; à l’edge, elle reste en mémoire. Votre clé API est échangée contre un jeton de courte durée, renouvelé silencieusement. Les modules propres à Node.js sont chargés à la demande, afin de ne pas casser les builds webpack, Vite ou Gatsby.

Les assistants sont des sessions, pas des prompts

Au lieu de reconstruire un prompt à chaque appel, vous créez une session d’assistant une seule fois : modèle, rôle, instructions, schéma JSON facultatif et mémoire. Chaque appel generate() utilise ensuite des entrées et sorties typées. La même forme transporte texte, images, audio, vidéo et extraits de documents.

const assistant = await api.models.create({ model: "gemini-3.5-flash", settings: { role: "Senior release engineer", instructions: "Answer in three short bullet points." }, schema: { type: "object", properties: { summary: { type: "string" } } }, memory: true });
const first = await assistant.generate({ inputs: [{ type: "text", content: "Summarise the changes shipped in v2.4.0." }] });
const followUp = await assistant.generate({ inputs: [{ type: "text", content: "Which risk should we fix first?" }] });

Le serveur publie son propre catalogue tarifaire, lu par api.catalogue(). Une application peut donc afficher le coût d’un appel sans recopier une grille qui finirait par diverger.

Un agent avec un budget visible

Le travail d’un agent ne doit pas devenir un coût sans limite. Chaque exécution porte le budget que vous fixez, et sa trace montre les outils utilisés, les décisions prises et le résultat remis à votre application.

Vous composez un agent à partir de sessions de modèles et d’outils intégrés : recherche web, lecture de pages, captures, conversion de documents et génération d’images, vidéo, voix ou musique. maxSteps limite la boucle et budget limite les crédits. Le budget est vérifié avant chaque outil selon des coûts mesurés en production.

const agent = api.agents.create({ model: { main, image }, tools: { search: api.tools.search, openPage: api.tools.fetch, createImage: api.tools.image }, maxSteps: 8, budget: 100 });
const result = await agent.run({ inputs: [{ type: "text", content: "Find the latest Node.js LTS release and draw a cover image for it." }] });

Les erreurs conservent leur type même au milieu d’une exécution diffusée en direct : instanceof NotEnoughCredits fonctionne donc aussi bien pour un appel simple que pour un agent de cinq minutes.

La sortie structurée est la voie normale

Une application a besoin de données fiables, pas d’un paragraphe à analyser après coup. Le SDK fait des résultats structurés et des erreurs typées le chemin normal, dans un navigateur, un worker ou un processus serveur.

C’est une alpha. Nous gardons volontairement une interface réduite pendant que nous apprenons des applications réelles et stabilisons ce qui doit durer.

Le SDK est le début de l’expérience développeur, pas son remplacement. La documentation et le site développeur grandiront autour des éléments réellement utiles.

Ce qui vient ensuite

Une alpha promet une direction, pas un calendrier. Nous avançons vers des intégrations adaptées aux frameworks, un retour en direct pour les appels ordinaires, une mémoire alimentée par le stockage et nos propres modèles accessibles par le même models.create().

L’alpha est partagée avec les équipes en accès anticipé pendant que l’API se stabilise ; certains noms peuvent encore changer. Pour construire avec elle, contactez-nous et suivez l’évolution de la documentation IaGenify.