文档目录
DOCUMENTATION

TokenSupply API 文档

通过一个 Base URL 和 API Key,使用 OpenAI 兼容接口、官方 SDK 或 Codex CLI 调用 TokenSupply 提供的模型。

Base URL: https://www.tokensupply.net/v1最后更新:2026-07-31

快速开始

从创建密钥到收到第一个模型响应,只需要完成下面四步。

注册并进入控制台

登录 TokenSupply,在控制台确认账户余额和可用分组。

创建 API Key

进入“API Keys”,创建密钥并选择可用分组。

设置环境变量

推荐使用环境变量等安全方式储存密钥,切勿将密钥写进源码或公开仓库。

发送第一个请求

查询模型列表,任选一个返回的模型来调用 Responses API。

Terminal
export TOKENSUPPLY_API_KEY="sk-your-key"

curl https://www.tokensupply.net/v1/models \
  -H "Authorization: Bearer $TOKENSUPPLY_API_KEY"
POST /v1/responses
curl https://www.tokensupply.net/v1/responses \
  -H "Authorization: Bearer $TOKENSUPPLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Explain quantum entanglement in one sentence",
    "stream": false
  }'
模型以接口返回为准不同 API Key 分组可见的模型可能不同,使用前应先调用 GET /v1/models,使用实际返回的模型。

Base URL 与鉴权

OpenAI 兼容客户端统一使用下面的 API 根地址:

Base URL
https://www.tokensupply.net/v1

推荐使用标准 Bearer 请求头:

HTTP header
Authorization: Bearer sk-your-key

服务端也兼容 x-api-key 和 x-goog-api-key 请求头。出于安全和日志泄露风险,URL 查询参数中的 key 或 api_key 已被弃用并会返回 400。

密钥安全推荐以安全的形式保存 API Key。切勿将密钥放入浏览器前端代码、URL、公开日志或 Git 仓库。

公开端点总览

下面列出通用文本调用和账户自省端点。可用能力最终由 API Key 所属分组决定。

GET/v1/models返回当前 API Key 所属分组允许调用的模型列表。
POST/v1/responses推荐的统一文本生成接口,支持非流式响应与 SSE 流式输出。
POST/v1/chat/completions兼容使用 OpenAI Chat Completions 协议的现有应用。
GET/v1/responsesResponses WebSocket 升级入口。仅在客户端、API Key 分组和上游账号均支持时使用。
GET/v1/usage查询当前 API Key 的余额、额度和用量摘要。
GET/v1/sub2api/billing查询当前 API Key 实际生效的文本 Token 计费倍率。
图像与其他兼容协议平台还包含图像生成兼容端点,实际开放状态取决于分组配置。请以控制台和 /v1/models 的实际返回为准。

继续阅读