API 端点

大多数客户端在配置时需要填写 API 地址（Base URL）。TokenFlux 按协议格式提供三个入口。

协议入口

协议格式	Base URL	典型请求路径
OpenAI 格式	`https://tokenflux.dev/v1`	`POST /chat/completions` 或 `POST /responses`
Anthropic 格式	`https://tokenflux.dev`	`POST /v1/messages`
Gemini 格式	`https://tokenflux.dev`	`POST /v1beta/models/<模型 ID>:generateContent`

OpenAI 格式和 Anthropic 格式的端点可在 API 密钥页面顶部一键复制：

格式由客户端决定，分组必须支持同一格式。

格式	适用客户端
OpenAI 格式（`/v1` 结尾）	OpenCode、DeepSeek Harness（选择 OpenAI 协议时），以及标注「OpenAI 兼容」的工具
Anthropic 格式（无 `/v1`）	`Claude Code` 等原生走 Anthropic 协议的客户端
Gemini 格式	使用 Google 原生协议的客户端和 SDK，模型 ID 写在请求路径里

客户端配置项写 ANTHROPIC_BASE_URL 的用 Anthropic 格式，写 OPENAI_BASE_URL 的用 OpenAI 格式。Base URL 是通用字段名，不能据此判断协议，应先确认所选供应商类型。具体填法各接入教程里都有写明。

OpenAI 格式包含 Chat Completions 和 Responses 等不同接口；例如 Codex 使用 Responses。Base URL 相同不代表模型支持所有接口，需确认分组和模型支持客户端实际发送的请求。完整测试请求见排障。

生图超时可尝试流式生图。

API Key 通过请求头传递，多数客户端会自动处理。

入口	支持的认证方式
OpenAI 格式、Anthropic 格式	`Authorization: Bearer <Key>`、`x-api-key: <Key>`、`x-goog-api-key: <Key>`
Gemini 格式	以上三种，另支持查询参数 `?key=<Key>`

OpenAI 格式和 Anthropic 格式不接受通过查询参数传 Key，会返回 400。Gemini 格式的 ?api_key= 同样已废弃，请使用 ?key= 或请求头。

使用复合 Key 时，模型 ID 需要带前缀，Gemini 格式的前缀写在路径中。