API 指南

API 指南

JoyToken 当前公开给开发者的是 OpenAI 兼容模型网关。应用侧把 OpenAI SDK 或 HTTP 客户端的 base URL 指向 JoyToken 即可接入。

公开接口

接口认证用途
POST /openai/v1/chat/completions需要 API Key聊天补全，支持非流式和 SSE 流式响应
GET /api/v1/models不需要 API Key获取公开模型目录

基础 URL

场景基础 URL
OpenAI 兼容模型调用从 环境 选择 JOY_TOKEN_OPENAI_BASE_URL
JoyToken API从 环境 选择 JOY_TOKEN_API_BASE_URL

认证

Authorization: Bearer $JOY_TOKEN_API_KEY

兼容旧客户端时也可以使用：

X-API-Key: $JOY_TOKEN_API_KEY

不要在同一个请求里同时传 Authorization 和 X-API-Key。如果两个都存在，当前网关会优先读取 X-API-Key。

最小请求

$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响应体模型输出
usage响应体tokens 和成本统计
metadata.billing响应体 / 流式 metadataJoyToken 计费信息
X-DAOE-Used-Model响应头实际命中的模型
X-DAOE-Used-Provider响应头实际提供方
X-Request-ID请求头日志和排障关联