概览与认证
TokenJoy API 兼容 OpenAI 和 Anthropic 的接口格式。所有接口都在同一个地址下:
https://api.tokenjoy.org
认证
在请求头中携带 API Key,以下三种方式任选其一:
| 请求头 | 常见用法 |
|---|---|
Authorization: Bearer <Key> | OpenAI SDK 及大部分工具 |
x-api-key: <Key> | Anthropic SDK、Claude Code |
x-goog-api-key: <Key> | Gemini 格式的客户端 |
接口列表
| 接口 | 说明 |
|---|---|
POST /v1/chat/completions | OpenAI Chat Completions,支持流式 |
POST /v1/responses | OpenAI Responses,Codex 使用 |
POST /v1/messages | Anthropic Messages,支持流式 |
POST /v1/messages/count_tokens | 计算输入的 token 数 |
POST /v1/embeddings | 文本向量 |
GET /v1/realtime | 实时语音(WebSocket),GPT Realtime 模型 |
GET /v1/models | 当前可用的模型列表 |
出错时返回对应的 HTTP 状态码和 JSON 格式的错误信息,见错误码。