客户端 SDK
TypeScript
面向 Node.js 与服务端运行时的类型化请求
服务端 TypeScript 使用 @octoryn/sdk。API Key 保留在运行环境,并把应用 Deadline 传入 Transport。
安装
固定当前 Major Version,避免生产环境自动跨 Major 升级。
npm install @octoryn/sdk@3.0.0创建 Client
每套服务配置复用一个 Client,由运行环境提供 API Key。
import { Octoryn } from "@octoryn/sdk";
const client = new Octoryn({
apiKey: process.env.OCTORYN_API_KEY!,
baseURL: "https://api.octoryn.dev/v1",
});高级请求
SDK 覆盖文本、Streaming、Tool Calling 与 JSON Schema 请求。应用必须检查流终态,并在使用前重新验证结构化对象。
按类型处理错误
保留 Status、Error Type 与 Request ID;不要用通用自动重试掩盖策略拒绝或校验失败。
