API 概览

TokenFlux API 是一个兼容 OpenAI 的网关，可以调用多种模型。你的 agent 也使用同一个网关。一个账户和一份余额同时支付两者。

Base URL 和认证复制标题链接

https://tokenflux.ai/v1

在 API 密钥页面创建密钥，然后作为 Bearer token 发送：

Authorization: Bearer YOUR_TOKENFLUX_KEY

大多数 SDK 只需要 base URL 和密钥。已有的集成可以继续使用 base URL https://api.tokenflux.ai/openai/v1 和 https://api.tokenflux.ai/anthropic/v1，它们访问的是同样的端点。

端点复制标题链接

以上是文档支持的端点。请不要依赖其他路径。

模型复制标题链接

使用 GET /v1/models 返回的模型 ID，或模型与价格页面上的模型 ID。一把密钥能调用哪些模型，取决于它的访问权限，所以请用你实际使用的密钥获取模型列表。

不是每个模型都支持每个端点。模型与价格页面的模型详情会列出它支持的协议。当请求通过另一种协议到达模型时，TokenFlux 会转换请求。Chat Completions 和 Responses 之间的转换效果好。其他转换可能丢失供应商特有的功能，例如 thinking 签名、cache_control 或托管工具。需要这些功能时，请调用模型原生支持的端点。

流式复制标题链接

把 stream 设为 true，即可按兼容 API 的格式接收 server-sent events。关闭连接会取消请求。

错误复制标题链接

错误使用兼容 API 的 JSON 错误格式，并返回 HTTP 错误状态码。如果 TokenFlux 无法连接模型服务，会返回 HTTP 502，响应体如下：

{ "message": "Service temporarily unavailable" }

遇到 429 和 5xx 错误时，请按退避策略重试。遇到其他 4xx 错误时，请先修正请求、密钥或余额，再重试。

计费复制标题链接

每个请求按模型与价格上的价格，计入密钥所属的账户。用量列出每个请求的模型、密钥、token 数量和费用。