首次调用 API

TokenJoy 的 API 同时兼容 OpenAI 和 Anthropic 的接口格式。修改 base_url 和 api_key 后，就可以用这两家的 SDK，或任何兼容它们的软件访问本站的全部模型。

完整的 Key 只显示一次，请立即复制并妥善保存。遗失后可以在控制台重置，生成新的 Key。

接入 Agent 工具

不用写代码，把本站设为下面这些 Agent 工具的模型提供方，就能直接开始使用：

其他工具（OpenCode、OpenClaw、Cursor、Cline 等）详见 Agent 工具接入指南。

调用对话 API

创建 API Key 后，可以用下面的样例脚本调用模型。样例为非流式输出，把 stream 设为 true 即可流式输出。两种格式可以调用同一个模型，本站会自动转换。

先把 Key 设置为环境变量 TOKENJOY_API_KEY，例如 export TOKENJOY_API_KEY="<你的 API Key>"。

curl https://api.tokenjoy.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKENJOY_API_KEY}" \
  -d '{
        "model": "gpt-5",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "stream": false
      }'

更多用法见 API 指南：使用 OpenAI API、使用 Anthropic API。

用 AI 编程助手接入时，可以把本站给 AI 读的文档交给它，见让 AI 读文档。