快速开始

跑通一条端到端的请求。完整的可运行片段目录（流式、Anthropic、模型列表、错误处理）见 示例。

前置条件

项目值
API KeyJOY_TOKEN_API_KEY
API Base URL从 环境 选择 JOY_TOKEN_API_BASE_URL
模型auto（不可配置）
TypeScriptNode.js 18+
GoGo 1.22+

第 1 步：设置环境

export JOY_TOKEN_API_KEY="sk-xxx"
export JOY_TOKEN_OPENAI_BASE_URL="https://api.joytokens.ai/openai/v1"

两个 SDK 默认使用 60 秒的请求/流式超时。仅当工作负载需要不同上限时再覆盖——TypeScript 用 timeoutMs，Go 用 WithTimeout。

第 2 步：安装

TypeScript 从 GitHub 分发，不在 npm registry 上。把包子目录加入 package.json：

{
  "type": "module",
  "dependencies": {
    "@joytoken/client-sdk-ts": "git+https://github.com/jd-opensource/joytoken-sdk-ts.git#path:/client-sdk-ts"
  }
}
pnpm install

为保证可复现构建，请固定到某个发布 tag 或 commit，而不是跟随默认分支。

第 3 步：发出第一条请求

import { JoyTokenClient } from "@joytoken/client-sdk-ts";
const apiKey = process.env.JOY_TOKEN_API_KEY;
if (!apiKey) throw new Error("JOY_TOKEN_API_KEY is required");
const joytoken = new JoyTokenClient({
  apiKey,
  openAIBaseUrl: process.env.JOY_TOKEN_OPENAI_BASE_URL,
});
const completion = await joytoken.chat.completions.create({
  model: "auto",
  messages: [{ role: "user", content: "Reply with exactly: pong" }],
});
console.log(completion.choices[0]?.message?.content);

校验结果

位置期望结果
程序输出pong
JoyToken 日志请求到达 OpenAI Chat Completions 端点
JoyToken 用量记录到 token 与额度

常见错误

错误处理
401 Unauthorized检查 JOY_TOKEN_API_KEY 是否存在且完整
403 Forbidden检查 API Key 策略是否允许 auto 或目标模型
402 insufficient_quota检查钱包余额与 Key 预算
超时增大 SDK 超时或检查到所选环境的连通性

下一步