IaGenify SDK Alpha: um único cliente, onde quer que seu código rode.

O SDK IaGenify começou como uma fina camada HTTP sobre nossa API. Na versão alpha, tornou-se a ferramenta com que construímos nossos produtos: um cliente JavaScript que roda igual no Node.js, navegador e Cloudflare Workers e esconde autenticação, sessões e limites de cobrança atrás de uma interface orientada a objetos.

Isto não é um manual de referência. É um passeio pelas ideias em que apostamos, pela sintaxe real e pela direção do SDK.

Um cliente, onde quer que seu código rode

O cliente detecta o ambiente ao iniciar e gerencia autenticação, sessões e limites de cobrança para que o aplicativo se concentre no trabalho.

import { IaGenify } from "iagenify";

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

No Node.js a sessão fica em um arquivo privado sob ~/.iagenify/; no navegador usa localStorage; no edge permanece na memória. A chave de API vira um token curto renovado silenciosamente. Módulos exclusivos do Node.js carregam sob demanda para não quebrar builds webpack, Vite ou Gatsby.

Assistentes são sessões, não prompts

Em vez de reconstruir um prompt, você cria uma sessão com modelo, papel, instruções, JSON Schema opcional e memória. Cada generate() usa entradas e saídas tipadas, incluindo texto, imagens, áudio, vídeo e 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?" }] });

O servidor publica seu catálogo e api.catalogue() o lê. Assim, o aplicativo mostra custos sem copiar uma tabela que pode ficar desatualizada.

Um agente com orçamento visível

O trabalho do agente não deve virar um custo aberto. Cada execução leva seu orçamento e uma trilha das ferramentas, decisões e resultados.

O agente combina modelos com busca web, leitura de páginas, capturas, conversão de documentos e geração multimídia. maxSteps limita o ciclo e budget limita créditos, verificados antes de cada ferramenta com custos medidos em produção.

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

Os erros mantêm o tipo mesmo durante streaming; instanceof NotEnoughCredits funciona numa chamada simples ou num agente de cinco minutos.

Saída estruturada é o caminho normal

Aplicativos precisam de dados confiáveis, não de um parágrafo para analisar. Resultados estruturados e erros tipados são o caminho normal no navegador, worker ou servidor.

Esta é uma alpha. Mantemos a interface pequena enquanto aprendemos com aplicações reais e estabilizamos o que deve durar.

O SDK inicia a experiência do desenvolvedor, não a substitui. A documentação e o site crescerão em torno do que provar seu valor.

O que vem a seguir

Uma alpha promete direção, não datas. Seguimos para integrações com frameworks, retorno ao vivo, memória baseada em armazenamento e modelos próprios acessíveis pelo mesmo models.create().

A alpha é compartilhada com equipes de acesso antecipado enquanto a API se estabiliza; nomes ainda podem mudar. Para construir com ela, fale conosco e acompanhe a documentação IaGenify.