文档目录
DOCUMENTATION
TokenSupply API 文档
通过一个 Base URL 和 API Key,使用 OpenAI 兼容接口、官方 SDK 或 Codex CLI 调用 TokenSupply 提供的模型。
快速开始
从创建密钥到收到第一个模型响应,只需要完成下面四步。
注册并进入控制台
登录 TokenSupply,在控制台确认账户余额和可用分组。
创建 API Key
进入“API Keys”,创建密钥并选择可用分组。
设置环境变量
推荐使用环境变量等安全方式储存密钥,切勿将密钥写进源码或公开仓库。
发送第一个请求
查询模型列表,任选一个返回的模型来调用 Responses API。
export TOKENSUPPLY_API_KEY="sk-your-key"
curl https://www.tokensupply.net/v1/models \
-H "Authorization: Bearer $TOKENSUPPLY_API_KEY"
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
}'import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKENSUPPLY_API_KEY"],
base_url="https://www.tokensupply.net/v1",
)
response = client.responses.create(
model="gpt-5.6-sol",
input="Explain quantum entanglement in one sentence",
)
print(response.output_text)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TOKENSUPPLY_API_KEY,
baseURL: "https://www.tokensupply.net/v1",
});
const response = await client.responses.create({
model: "gpt-5.6-sol",
input: "Explain quantum entanglement in one sentence",
});
console.log(response.output_text);
模型以接口返回为准不同 API Key 分组可见的模型可能不同,使用前应先调用
GET /v1/models,使用实际返回的模型。
Base URL 与鉴权
OpenAI 兼容客户端统一使用下面的 API 根地址:
https://www.tokensupply.net/v1
推荐使用标准 Bearer 请求头:
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 的实际返回为准。