> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.joytokens.ai/llms.txt.

# 客户端 SDK

> 使用 JoyToken 客户端 SDK 调用公开 API

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

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

## 选择 SDK

| 语言         | 包                                          | 源码                                                                                        | 指南                                                        |
| ---------- | ------------------------------------------ | ----------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| TypeScript | `@joytoken/client-sdk-ts`                  | [client-sdk-ts](https://github.com/jd-opensource/joytoken-sdk-ts/tree/main/client-sdk-ts) | [TypeScript SDK](/zh/client-sdk/type-script-sdk/overview) |
| Go         | `github.com/jd-opensource/joytoken-sdk-go` | [joytoken-sdk-go](https://github.com/jd-opensource/joytoken-sdk-go)                       | [Go SDK](/zh/client-sdk/go-sdk/overview)                  |

可运行的示例项目：[TypeScript 示例](https://github.com/jd-opensource/joytoken-sdk-ts/tree/main/example) · [Go 示例](https://github.com/jd-opensource/joytoken-sdk-go/tree/main/example)。

## 你能做什么

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

| 能力                 | TypeScript | Go                  | 从哪开始                                                                                           |
| ------------------ | ---------- | ------------------- | ---------------------------------------------------------------------------------------------- |
| Chat Completions   | 支持         | 支持                  | [示例 → Chat](/zh/client-sdk/examples#chat-completions)                                          |
| OpenAI Responses   | 支持         | 支持                  | [示例 → Responses](/zh/client-sdk/examples#responses)                                            |
| Anthropic Messages | 支持         | 支持                  | [示例 → Anthropic](/zh/client-sdk/examples#anthropic-messages)                                   |
| 流式响应               | 支持         | 支持                  | [示例 → 流式](/zh/client-sdk/examples#streaming)                                                   |
| 图片生成               | 支持         | 支持                  | [API 参考](/zh/open-api/api-guides/overview)                                                     |
| 图片编辑               | 支持         | 支持                  | [API 参考](/zh/open-api/api-guides/overview)                                                     |
| 模型列表               | 支持         | 支持                  | [示例 → 模型列表](/zh/client-sdk/examples#model-list)                                                |
| 工具调用循环             | 自动         | `RunChatCompletion` | [TS](/zh/client-sdk/type-script-sdk/overview#工具调用) · [Go](/zh/client-sdk/go-sdk/overview#工具调用) |
| 错误处理               | 支持         | 支持                  | [示例 → 错误处理](/zh/client-sdk/examples#error-handling)                                            |

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

## 工具调用循环如何工作

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

完整的工具调用参考见 [TypeScript](/zh/client-sdk/type-script-sdk/overview#工具调用) 或 [Go](/zh/client-sdk/go-sdk/overview#工具调用)。

## 你需要准备

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

| 项目           | 值                                                               |
| ------------ | --------------------------------------------------------------- |
| API Key      | `JOY_TOKEN_API_KEY`                                             |
| API Base URL | 从 [环境](/zh/user-guide/environments) 选择 `JOY_TOKEN_API_BASE_URL` |
| 请求模型         | `auto`（不可配置）                                                    |

#### OpenAI

Base URL：从 [环境](/zh/user-guide/environments) 选择 `JOY_TOKEN_OPENAI_BASE_URL`。

#### Anthropic

Base URL：从 [环境](/zh/user-guide/environments) 选择 `JOY_TOKEN_ANTHROPIC_BASE_URL`。

## 下一步

| 页面                                                        | 用途              |
| --------------------------------------------------------- | --------------- |
| [快速开始](/zh/client-sdk/quickstart)                         | 3 步安装并跑通第一条请求   |
| [示例](/zh/client-sdk/examples)                             | 复制每种能力的完整可运行示例  |
| [TypeScript SDK](/zh/client-sdk/type-script-sdk/overview) | 客户端选项、工具调用、错误类型 |
| [Go SDK](/zh/client-sdk/go-sdk/overview)                  | 客户端选项、工具调用、错误类型 |