客户端 SDK | JoyToken

客户端 SDK 适合在服务端应用里直接调用 JoyToken。当前 SDK 覆盖 JoyToken 已公开的开发者接口，不包含 Console 管理接口。

支持能力

能力	TypeScript SDK	Go SDK
聊天补全	支持	支持
流式响应	支持	支持
模型列表	支持	支持
Agent loop	使用 Agent SDK	使用应用代码实现

你需要准备

项目	值
API Key	`JOY_TOKEN_API_KEY`
API Base URL	从环境选择 `JOY_TOKEN_API_BASE_URL`
OpenAI Base URL	从环境选择 `JOY_TOKEN_OPENAI_BASE_URL`
默认模型	`auto`

选择 SDK

语言	包	页面
TypeScript	`@joytoken/client-sdk-ts`	左侧导航 `TypeScript SDK`
Go	`client-sdk-golang`	左侧导航 `Go SDK`

最小 TypeScript 调用

1 import { JoyTokenClient } from "@joytoken/client-sdk-ts";
2 
3 const joytoken = new JoyTokenClient({
4   apiKey: process.env.JOY_TOKEN_API_KEY,
5   apiBaseUrl: process.env.JOY_TOKEN_API_BASE_URL,
6   openAIBaseUrl: process.env.JOY_TOKEN_OPENAI_BASE_URL,
7 });
8 
9 const completion = await joytoken.chat.completions.create({
10   model: "auto",
11   messages: [{ role: "user", content: "Reply with exactly: pong" }],
12 });
13 
14 console.log(completion.choices[0]?.message?.content);

最小 Go 调用

1 client := joytoken.NewClient(
2 	joytoken.WithAPIKey(os.Getenv("JOY_TOKEN_API_KEY")),
3 	joytoken.WithAPIBaseURL(os.Getenv("JOY_TOKEN_API_BASE_URL")),
4 	joytoken.WithOpenAIBaseURL(os.Getenv("JOY_TOKEN_OPENAI_BASE_URL")),
5 )
6 
7 completion, err := client.CreateChatCompletion(ctx, joytoken.ChatCompletionRequest{
8 	Model: "auto",
9 	Messages: []joytoken.ChatMessage{
10 		{Role: "user", Content: "Reply with exactly: pong"},
11 	},
12 })

下一步

页面	用途
快速开始	跑通第一条 SDK 请求
示例	复制模型列表、流式响应、错误处理示例
Agent SDK	需要工具调用、多步执行、停止条件时使用