概览

快速开始

JoyToken 是 OpenAI 兼容模型网关。应用侧只需要把模型请求发到 JoyToken，JoyToken 负责 API Key、路由、策略、钱包额度、用量和账单归因。

你需要准备

项目值
API KeyJOY_TOKEN_API_KEY=jt_xxx
OpenAI 兼容 Base URL从 环境 选择 JOY_TOKEN_OPENAI_BASE_URL
起始模型auto
请求 IDX-Request-ID: quickstart-001

第 1 步：设置环境

$export JOY_TOKEN_API_KEY="jt_xxx"
$export JOY_TOKEN_OPENAI_BASE_URL="https://api-dev.joytokens.ai/openai/v1"

API Key 只放在服务端环境变量、secret manager 或 CI/CD secret 里。不要放到浏览器、移动端包、公开仓库或日志中。

第 2 步：发送请求

$curl "$JOY_TOKEN_OPENAI_BASE_URL/chat/completions" \
>  -H "Content-Type: application/json" \
>  -H "Authorization: Bearer $JOY_TOKEN_API_KEY" \
>  -H "X-Request-ID: quickstart-001" \
>  -d '{
>    "model": "auto",
>    "messages": [
>      { "role": "user", "content": "Reply with exactly: pong" }
>    ],
>    "stream": false
>  }'

成功时，choices[0].message.content 包含模型回复。

第 3 步：使用 OpenAI SDK

1import OpenAI from "openai";
2
3const client = new OpenAI({
4  apiKey: process.env.JOY_TOKEN_API_KEY,
5  baseURL: process.env.JOY_TOKEN_OPENAI_BASE_URL,
6});
7
8const response = await client.chat.completions.create({
9  model: "auto",
10  messages: [{ role: "user", content: "Reply with exactly: pong" }],
11});
12
13console.log(response.choices[0]?.message?.content);

第 4 步：检查接入

位置应看到
HTTP 响应choices[0].message.content 有内容
响应头X-DAOE-Used-Model 和 X-DAOE-Used-Provider
JoyToken Console日志和用量归因到这把 API Key

选择下一步

目标页面
API Key 和服务端代理认证
auto 和固定模型模型
tier、固定模型、钱包回退路由
API Key 策略和预算策略保护
Credits 和用量归因用量与账单
状态码和排障故障排查