IaGenify SDK Alpha：无论代码在哪里运行，都只需一个客户端。

IaGenify SDK 最初只是 API 上的一层轻量 HTTP 封装。进入 Alpha 后，它已成为我们构建自身工具的方式：一个可在 Node.js、浏览器和 Cloudflare Workers 中原样运行的 JavaScript 客户端，用小巧的面向对象接口隐藏认证、会话和计费护栏。

这不是参考手册，而是一次简短导览：我们押注的理念、你真正会写的语法，以及 SDK 接下来的方向。

一个客户端，适用于代码运行的每个地方

客户端启动时会检测运行环境，并处理认证、会话和计费护栏，让应用专注于真正的任务。

import { IaGenify } from "iagenify";

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

在 Node.js 中，会话保存在 ~/.iagenify/ 下仅限所有者访问的私有文件；浏览器使用 localStorage；边缘环境保存在内存。API 密钥会换成自动静默刷新的短期令牌。Node.js 专用模块按需加载，因此共享导入不会破坏 webpack、Vite 或 Gatsby 构建。

助手是会话，而不是 prompts

你无需为每次调用重建 prompt，只需创建一次包含模型、角色、指令、可选 JSON Schema 与记忆的助手会话。之后每次 generate() 都使用类型化输入输出，同一结构支持文本、图片、音频、视频与文档片段。

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

服务器发布自己的价格目录，api.catalogue() 直接读取。应用无需复制一份终将过时的价格表，也能显示调用成本。

预算清晰可见的智能体

智能体工作不应带来无上限成本。每次运行都携带你设定的预算，并通过轨迹展示工具、决策和最终结果。

智能体由已有模型会话和内置工具组成：网页搜索、页面读取、截图、文档转换及多媒体生成。maxSteps 限制循环，budget 限制额度；每次工具调用前都会按生产实测成本检查预算。

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

即使错误发生在流式运行中，也会保留类型，因此 instanceof NotEnoughCredits 对简单调用和长时间智能体运行同样有效。

结构化输出是默认路径

应用需要可信数据，而不是事后解析一段文字。SDK 让结构化结果和类型化错误成为浏览器、Worker 与服务器中的正常路径。

这是 Alpha。我们刻意保持接口精简，同时从真实应用中学习并稳定需要长期保留的部分。

SDK 是开发者体验的起点，而非替代品。文档与开发者网站将围绕真正证明有用的能力继续成长。

接下来会发生什么

Alpha 承诺的是方向，不是日期：面向框架的集成、普通助手调用的实时反馈、以存储作为智能体记忆，以及通过同一 models.create() 使用的自研模型。

API 稳定期间，Alpha 会与早期访问团队共享，部分名称仍可能改变。若想参与构建，请联系我们并关注不断完善的 IaGenify 文档。