Client SDKs

JoyToken Client SDKs are thin clients over the public developer API. They handle authentication headers, request typing, streaming parsing, model listing, and normalized API errors while keeping application orchestration in your code.

SDKs

Both SDKs cover the same public API surface:

Install

$
pnpm add @joytoken/client-sdk-ts

Quick example

1
import { JoyTokenClient } from "@joytoken/client-sdk-ts";
2
3
const client = new JoyTokenClient({
4
  apiKey: process.env.JOY_TOKEN_API_KEY,
5
});
6
7
const response = await client.chat.completions.create({
8
  model: "auto",
9
  messages: [
10
    { role: "user", content: "Explain JoyToken in one sentence." },
11
  ],
12
});
13
14
console.log(response.choices[0]?.message?.content);

When to use Client SDKs

Choose a Client SDK when your application owns the orchestration and you want a typed model-call client.

Client SDKs vs Agent SDK

Next steps