IaGenify SDK Alpha: un solo cliente, dondequiera que se ejecute tu código.

El SDK de IaGenify nació como una fina capa HTTP sobre nuestra API. En su alfa se ha convertido en la herramienta con la que construimos nuestros propios productos: un cliente JavaScript que funciona igual en Node.js, el navegador y Cloudflare Workers y oculta autenticación, sesiones y controles de facturación tras una pequeña interfaz orientada a objetos.

Esto no es un manual de referencia. Es un recorrido por las ideas en las que apostamos, con ejemplos de la sintaxis real y pistas sobre el futuro del SDK.

Un cliente, dondequiera que se ejecute tu código

El cliente detecta su entorno al iniciarse. Gestiona autenticación, sesiones y controles de facturación para que la aplicación se concentre en su trabajo.

import { IaGenify } from "iagenify";

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

En Node.js guarda la sesión en un archivo privado bajo ~/.iagenify/; en el navegador usa localStorage; en el edge permanece en memoria. La clave API se intercambia por un token breve que se renueva silenciosamente. Los módulos exclusivos de Node.js se cargan bajo demanda para no romper builds de webpack, Vite o Gatsby.

Los asistentes son sesiones, no prompts

En lugar de reconstruir un prompt en cada llamada, creas una sesión con modelo, rol, instrucciones, JSON Schema opcional y memoria. Cada generate() usa entradas y salidas tipadas, y la misma forma admite texto, imágenes, audio, vídeo y documentos.

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

El servidor publica su propio catálogo de precios y api.catalogue() lo lee. Una aplicación puede mostrar el coste sin copiar una tabla destinada a quedar obsoleta.

Un agente con presupuesto visible

El trabajo de un agente no debe convertirse en un coste abierto. Cada ejecución lleva el presupuesto que defines y una traza de herramientas, decisiones y resultados.

El agente combina sesiones de modelos con búsqueda web, lectura de páginas, capturas, conversión documental y generación multimedia. maxSteps limita el ciclo y budget los créditos. El presupuesto se comprueba antes de cada herramienta con costes medidos en producción.

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." }] });

Los errores mantienen su tipo incluso durante una ejecución transmitida, por lo que instanceof NotEnoughCredits funciona igual en una llamada simple y en un agente de cinco minutos.

La salida estructurada es el camino normal

Las aplicaciones necesitan datos fiables, no un párrafo que analizar. El SDK convierte los resultados estructurados y errores tipados en el camino habitual en navegador, worker o servidor.

Esto es una alfa. La superficie se mantiene pequeña mientras aprendemos de aplicaciones reales y estabilizamos lo que debe durar.

El SDK inicia la experiencia de desarrollo, no la sustituye. La documentación y el sitio para desarrolladores crecerán alrededor de lo que demuestre ser útil.

Lo que viene después

Una alfa promete una dirección, no fechas. Avanzamos hacia integraciones conscientes del framework, respuesta en directo, memoria basada en almacenamiento y modelos propios accesibles mediante el mismo models.create().

La alfa se comparte con equipos de acceso anticipado mientras la API se estabiliza y algunos nombres aún pueden cambiar. Para construir con ella, contáctanos y sigue la documentación de IaGenify.