TypeScript SDK
@joytoken/client-sdk-ts 是 JoyToken 公开开发者 API 的类型化客户端。它面向服务端 JavaScript runtime:Node.js 服务、Next.js route handler、worker 和 Agent runtime。
为什么使用 TypeScript SDK
SDK 在 JoyToken API 上提供一层很薄的类型和工具封装,不改变底层聊天补全契约。
安装
配置
client.ts
默认值:
聊天补全
chat.ts
流式响应
stream.ts
JoyToken 会在流式响应结束前追加元数据事件。带 metadata 的分块应作为观测数据记录,不要当成 assistant 文本渲染。
模型列表
models.ts
错误处理
errors.ts
Next.js 路由示例
app/api/chat/route.ts
JoyToken API Key 只能放在服务端,不要暴露到浏览器代码里。