用途:@inferencesh/sdk 是 inference.sh 的 JavaScript/TypeScript SDK,用于在 Node.js 或浏览器中运行 AI 应用、构建智能体并集成 250+ 模型。
安装与认证:npm install @inferencesh/sdk(也支持 yarn/pnpm),要求 Node.js 18.0.0+ 或支持 fetch 的现代浏览器。通过 inference({ apiKey: 'inf_your_key' }) 或环境变量 INFERENCE_API_KEY 认证;前端应用建议使用 proxyUrl 走服务端代理。
主要能力:client.run 执行应用,支持 app、input、setup、infra、session、session_timeout 参数;可等待完成、fire-and-forget(wait:false)或流式(stream:true)获取状态与日志。支持自动或手动文件上传(uploadFile,含浏览器 File 对象)。会话可保持 worker 热启动。Agent SDK 支持模板智能体与编程式临时智能体,可定义客户端工具、应用工具、子智能体工具、Webhook 工具及内置工具(规划、记忆、网页搜索、代码执行、图像生成),并支持流式响应、文件附件、技能上下文与人工审批。
前端集成:提供 Next.js、Express、Hono、Remix、SvelteKit 的服务端代理,避免在浏览器暴露 API 密钥。
限制:资料未提供具体收费、价格、平台覆盖范围或效果数据;使用需自行获取 API 密钥,前端必须经代理以保护密钥。