# API 端点

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

## 协议入口

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

OpenAI 格式和 Anthropic 格式的端点亦可在 [API 密钥页面](https://tryflux.net/keys) 顶部直接复制使用。


## 该选哪个格式

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

| 格式                       | 适用客户端                                                       |
| -------------------------- | ---------------------------------------------------------------- |
| OpenAI 格式（`/v1` 结尾）  | Cherry Studio、RikkaHub、OpenCode，以及标注「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 相同不代表模型支持所有接口，需确认分组和模型支持客户端实际发送的请求。完整测试请求见 [排障](https://docs.tryflux.net/docs/troubleshooting.md#发送最小推理请求)。

## 认证

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](https://docs.tryflux.net/docs/flux/composite-key.md) 时，模型 ID 需要带前缀，Gemini 格式的前缀写在路径中。

## 相关入口

- [创建 API Key](https://docs.tryflux.net/docs/flux/create-apikey.md) — 先拿到密钥
- [快速开始](https://docs.tryflux.net/docs/quickstart.md) — 按客户端选择接入方式
- [排障](https://docs.tryflux.net/docs/troubleshooting.md) — 连不上或配置无效时的排查顺序
- [错误码](https://docs.tryflux.net/docs/errors.md) — 认证与请求错误的完整清单