客户端 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;不要用通用自动重试掩盖策略拒绝或校验失败。

下一篇Python