# TokenJoy

> TokenJoy 是大模型 API 中转站，同时兼容 OpenAI 和 Anthropic 的接口格式：把 base_url 设为 https://api.tokenjoy.org/v1（OpenAI 格式）或 https://api.tokenjoy.org（Anthropic 格式），api_key 设为在 https://tokenjoy.org/console/keys 创建的 Key，就能用两家的 SDK 和兼容它们的 Agent 工具调用 Claude、GPT 等模型。

- 下面每一页都是 Markdown，网页版去掉末尾的 `.md` 即可打开。
- 全部文档合在一个文件里：https://tokenjoy.org/llms-full.txt
- 示例里的 `TOKENJOY_API_KEY` 是存放 API Key 的环境变量，`<你的 API Key>`、`sk-…` 等是 Key 的占位符。

## 快速开始

- [首次调用 API](https://tokenjoy.org/docs/first-call.md)：TokenJoy 的 API 同时兼容 OpenAI 和 Anthropic 的接口格式。
- [模型 & 价格](https://tokenjoy.org/docs/models.md)：下面是当前可以调用的模型，请求时把模型名填进 `model` 参数。
- [Token 用量计算](https://tokenjoy.org/docs/token-usage.md)：Token 是模型表示文本的基本单位，也是计费的依据，可以近似理解为「字」或「词」。
- [限速与隔离](https://tokenjoy.org/docs/rate-limit.md)：本站不对单把 Key 设置固定的请求数或并发上限。
- [错误码](https://tokenjoy.org/docs/error-codes.md)：调用 API 时可能遇到的错误，以及原因和解决方法：
- [服务状态](https://tokenjoy.org/docs/status.md)：TokenJoy 和各上游官方服务的实时状态，每分钟探测一次。
- [让 AI 读文档](https://tokenjoy.org/docs/for-ai.md)：本站的文档另有一份给 AI 读的 Markdown 版本，遵循 llms.txt 约定。

## 快速开始 · 接入 Agent 工具

- [接入 Claude Code](https://tokenjoy.org/docs/agents/claude-code.md)：Claude Code 是 Anthropic 推出的终端 AI 编程助手，使用 Anthropic 格式的接口，本站原生支持。
- [接入 Pi](https://tokenjoy.org/docs/agents/pi.md)：Pi 是 Mario Zechner 开源的终端 AI 编程助手，界面简洁，可以通过配置文件接入任意模型服务。
- [接入 Codex](https://tokenjoy.org/docs/agents/codex.md)：Codex 是 OpenAI 推出的 AI 编程助手，通过 Responses API 与模型交互，本站原生支持该格式。
- [接入 Hermes](https://tokenjoy.org/docs/agents/hermes.md)：Hermes 是 Nous Research 打造的开源 AI Agent，支持 macOS、Linux 和 Windows。
- [接入 CC Switch](https://tokenjoy.org/docs/agents/cc-switch.md)：CC Switch 是一款开源的桌面应用，支持 Windows、macOS 和 Linux，可以集中管理 Claude Code、Codex、OpenCode、OpenClaw、Hermes、Pi 等工具的模型提供方，点一下就能在不同提…
- [接入 DeepSeek Harness](https://tokenjoy.org/docs/agents/dsh.md)：DeepSeek Harness（`dsh`）是 DeepSeek 开源的 Agent 框架，目前处于开发者预览阶段，提供 Web UI。
- [接入 OpenCode](https://tokenjoy.org/docs/agents/opencode.md)：OpenCode 是一个开源 AI 编程助手，提供终端、桌面端等运行形式。
- [接入 OpenClaw](https://tokenjoy.org/docs/agents/openclaw.md)：OpenClaw 是一个开源的个人 AI 助手，可以接入飞书、微信等常用聊天工具，并通过 Skill 扩展能力。
- [接入 Cursor](https://tokenjoy.org/docs/agents/cursor.md)：Cursor 是基于 VS Code 的 AI 编辑器，支持自定义 OpenAI 兼容的接口地址。
- [接入 Cline](https://tokenjoy.org/docs/agents/cline.md)：Cline 是 VS Code 中的开源 AI 编程助手。
- [接入 WorkBuddy/CodeBuddy](https://tokenjoy.org/docs/agents/codebuddy.md)：WorkBuddy/CodeBuddy 是腾讯推出的 AI Agent 与编程助手，支持通过本地配置文件添加 OpenAI 兼容的自定义模型。
- [接入 Cherry Studio](https://tokenjoy.org/docs/agents/cherry.md)：Cherry Studio 是一款支持多家模型服务的桌面 AI 客户端。
- [接入其他 Agent](https://tokenjoy.org/docs/agents/other.md)：本文档没有单独介绍的 Agent 工具、编辑器插件和聊天客户端，只要支持自定义 API 地址，都可以接入本站。

## API 指南

- [多轮对话](https://tokenjoy.org/docs/guides/multi-round.md)：对话接口是无状态的，服务端不会记住之前的请求。
- [流式输出](https://tokenjoy.org/docs/guides/streaming.md)：把 `stream` 设为 `true`，模型会边生成边返回，以 SSE（Server-Sent Events）的形式逐段推送。
- [Tool Calls](https://tokenjoy.org/docs/guides/tool-calls.md)：Tool Calls 让模型可以调用外部工具。
- [使用 OpenAI API](https://tokenjoy.org/docs/guides/openai.md)：本站兼容 OpenAI 的 Chat Completions 接口。
- [使用 Responses API](https://tokenjoy.org/docs/guides/responses.md)：本站兼容 OpenAI 的 Responses 接口（`POST /v1/responses`），Codex 用的就是这个接口。
- [使用 Anthropic API](https://tokenjoy.org/docs/guides/anthropic.md)：本站兼容 Anthropic 的 Messages 接口。
- [实时语音](https://tokenjoy.org/docs/guides/realtime.md)：实时语音模型直接听语音、说语音：你把用户说的话（音频）发过去，模型用语音回答，同时给出文字稿。

## API 文档

- [概览与认证](https://tokenjoy.org/docs/api.md)：TokenJoy API 兼容 OpenAI 和 Anthropic 的接口格式。

## API 文档 · OpenAI 格式

- [对话补全](https://tokenjoy.org/docs/api/chat-completions.md)：根据对话历史生成回复，与 OpenAI Chat Completions 接口兼容。
- [Responses](https://tokenjoy.org/docs/api/responses.md)：OpenAI 的新一代对话接口，与 OpenAI Responses API 兼容，Codex 使用的就是这个接口。
- [向量](https://tokenjoy.org/docs/api/embeddings.md)：把文本转换成向量，用于检索、聚类等，与 OpenAI Embeddings 接口兼容。
- [实时语音](https://tokenjoy.org/docs/api/realtime.md)：建立一条 WebSocket 连接进行实时语音对话，与 OpenAI Realtime API（GA 版）兼容。

## API 文档 · Anthropic 格式

- [消息](https://tokenjoy.org/docs/api/messages.md)：根据对话历史生成回复，与 Anthropic Messages 接口兼容。
- [计算 Token 数](https://tokenjoy.org/docs/api/count-tokens.md)：计算一次请求的输入 token 数，不调用模型、不扣费。

## API 文档 · 其他

- [模型列表](https://tokenjoy.org/docs/api/models.md)：列出你的 Key 当前可以调用的模型，返回 OpenAI 格式的列表。

## Optional

- [Claude API 成本怎么算：Token 计算与省钱方法](https://tokenjoy.org/docs/news/api-cost.md)：上线一个 AI 功能之前，最常被问的问题是：这东西一个月要花多少钱？
- [更高的可用性：海外专用线路，不重试、不丢包、不封号](https://tokenjoy.org/docs/news/high-availability.md)：在国内直接调用海外的大模型，最让人头疼的往往不是价格，而是不稳定：
- [多家模型提供商，一个 API](https://tokenjoy.org/docs/news/multi-provider.md)：想同时用 Claude、GPT 和 Gemini，通常意味着：注册三个平台、绑三张卡、管三套 Key、看三份账单，还要在代码里写三套接入方式。
- [更好的性能：更高的并发，更低的延迟](https://tokenjoy.org/docs/news/performance.md)：性能看两件事：同时能跑多少请求，以及每个请求多快回来。
- [透明计费：透明标价，透明使用](https://tokenjoy.org/docs/news/transparent-pricing.md)：用 API 最怕的不是贵，而是算不清：单价藏在角落里，倍率说不明白，月底余额少了一截，却不知道花在了哪里。
- [一次请求扣多少钱](https://tokenjoy.org/docs/news/credits.md)：用一次真实请求说明。
- [Claude Code 接入 TokenJoy 的三种写法](https://tokenjoy.org/docs/news/claude-code.md)：Claude Code 只认两个变量：`ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN`。
- [TokenJoy 上线了](https://tokenjoy.org/docs/news/hello.md)：TokenJoy 开放注册了。
- [更新日志](https://tokenjoy.org/docs/updates.md)