客户端 SDK | JoyToken

客户端 SDK 面向服务端应用，用于直接调用 JoyToken。它封装了当前公开的开发者接口（不含 Console 管理接口），并在其上叠加了一个有步数上限的自动工具调用循环。

选好语言、安装、设置两个环境变量，5 分钟内即可发出第一条请求。

选择 SDK

语言	包	源码	指南
TypeScript	`@joytoken/client-sdk-ts`	client-sdk-ts	TypeScript SDK
Go	`github.com/jd-opensource/joytoken-sdk-go`	joytoken-sdk-go	Go SDK

可运行的示例项目：TypeScript 示例 · Go 示例。

下表每项能力都链接到一段完整、可复制运行的示例。

能力	TypeScript	Go	从哪开始
Chat Completions	支持	支持	示例 → Chat
OpenAI Responses	支持	支持	示例 → Responses
Anthropic Messages	支持	支持	示例 → Anthropic
流式响应	支持	支持	示例 → 流式
图片生成	支持	支持	API 参考
图片编辑	支持	支持	API 参考
模型列表	支持	支持	示例 → 模型列表
工具调用循环	自动	`RunChatCompletion`	TS · Go
错误处理	支持	支持	示例 → 错误处理

流式适用于 Chat Completions、Responses 和 Anthropic Messages；图片生成与图片编辑仅支持非流式。

客户端 SDK 在兼容接口之上运行一个有步数上限的工具调用循环：当模型返回 tool_calls 时，SDK 自动执行匹配的本地工具并把结果回填给模型，如此往复，直到模型给出最终消息或达到步数上限。安全、零配置的 calculator 和 datetime 工具默认注入。

完整的工具调用参考见 TypeScript 或 Go。

你始终只需要两样东西，外加协议对应的 Base URL。

Base URL：从环境选择 JOY_TOKEN_OPENAI_BASE_URL。