# API 概览

TokenPlan 提供 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 兼容接口，以及 SystemOne 结构化决策接口。本文档只承诺明确列出的字段与行为。

## Base URL

```text
OpenAI: https://discovery-api.intern-ai.org.cn/v1
Anthropic: https://discovery-api.intern-ai.org.cn
SystemOne: https://discovery-api.intern-ai.org.cn
```

SDK 配置使用 Base URL；直接发送 HTTP 请求时，请使用下表中的完整接口路径。

## 接口列表

| 协议 | 方法 | 路径 | 说明 |
|---|---|---|---|
| OpenAI | `GET` | `/v1/models` | 获取当前 API Key 可调用的模型 |
| OpenAI | `POST` | `/v1/chat/completions` | 创建聊天补全 |
| OpenAI | `POST` | `/v1/responses` | 创建模型响应，供 Agent 等场景使用 |
| Anthropic | `POST` | `/v1/messages` | 创建消息 |
| SystemOne | `POST` | `/v1/systemone` | 创建结构化决策，供判断/分类/护栏等场景使用 |


## 通用约定

- 请求和非流式响应使用 `application/json`。
- 流式响应使用 `text/event-stream`。
- OpenAI 兼容接口使用 Bearer Token，Anthropic 兼容接口使用对应的 Anthropic 鉴权头。
- 请求中的 `model` 必须使用 TokenPlan 对外提供的模型 ID。
- 模型可见不代表支持全部接口，具体以[模型限额与计费](../quick-start/04-model-limits-and-pricing.md)为准。
- 思考开关、默认强度和可选档位因模型和接口而异，详见[Chat Completions](./03-chat-completions.md#思考模式与强度)、[Responses](./04-responses.md#思考模式与强度)、[Anthropic Messages](./05-anthropic-messages.md#思考模式与强度)。
- Responses API 为无状态接口；传入 `previous_response_id` 会返回 HTTP `404`。
- SystemOne 决策接口仅支持非流式；请求传入 `stream` 参数会返回 HTTP `422`。
- 调用失败时，响应包含用于排查的 `request_id`。

鉴权配置请查看[鉴权：创建 API Key](../quick-start/01-authentication.md)，错误格式请查看[错误对象与公共响应头](07-errors-and-headers.md)。
