Source: https://wiki.niceai.dev/guide/glossary

# 术语表

本页用一两句话解释使用 AI API 和中转服务时最常见的名词，按主题分组。

## 接入相关

### API 中转

在用户和模型厂商之间转发 API 请求的服务。用户使用中转方提供的地址和密钥，按官方接口格式发请求，由中转方转发给上游模型并返回结果。

### Base URL

客户端或 SDK 发送请求的根地址，客户端会在后面拼接具体接口路径。NiceAI 的 OpenAI 兼容地址是 `https://api.niceai.dev/v1`，Anthropic 协议地址是 `https://api.niceai.dev`。见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### API 密钥（API Key）

调用接口时用于身份认证的字符串，相当于密码。OpenAI 兼容协议放在 `Authorization: Bearer` 请求头里，Anthropic 协议放在 `x-api-key` 请求头里。

### OpenAI 兼容

指接口的路径、请求和响应格式与 OpenAI 官方 API 一致，原本支持 OpenAI 的客户端改一下 Base URL 就能使用。

## 接口相关

### Chat Completions

OpenAI 的经典对话接口 `/v1/chat/completions`，以 `messages` 数组传入对话历史，无状态。绝大多数第三方客户端都支持。

### Responses API

OpenAI 较新的接口 `/v1/responses`，用 `input` 传入内容，支持推理过程、内置工具和多轮状态。Codex CLI 使用这个接口。见 [Chat Completions 与 Responses API 的区别](https://wiki.niceai.dev/guide/tech/responses-vs-chat-completions)。

### Messages API

Anthropic 的对话接口 `/v1/messages`，Claude Code 和 Anthropic SDK 使用它。

### 流式输出（Streaming）

模型边生成边返回，客户端逐字显示。OpenAI 和 Anthropic 都通过 SSE（Server-Sent Events）实现。

### 工具调用（Function Calling / Tool Use）

模型按约定格式输出要调用的函数和参数，由客户端执行后把结果返回给模型。Claude Code、Cline、Roo Code 等编程工具依赖这项能力。

## 计费相关

### token

模型处理文本的基本单位，计费按 token 数计算。一个汉字大约对应一到两个 token，具体取决于模型的分词方式。

### 输入 token 与输出 token

输入 token 是发给模型的内容（系统提示、历史、工具定义、你的问题），输出 token 是模型生成的内容。通常输出单价高于输入。

### 上下文窗口（Context Window）

模型一次请求能处理的最大 token 数，包括输入和输出。超过上限会报 400 错误。

### 提示词缓存（Prompt Caching）

把重复使用的请求前缀缓存起来，后续请求命中时按更低单价计费、响应也更快。见 [提示词缓存是怎么省钱的](https://wiki.niceai.dev/guide/tech/prompt-caching)。

### 缓存命中

本次请求的前缀与之前缓存的内容完全一致，这部分 token 按缓存读取的价格计费。

### 分组

NiceAI 中密钥的归属类别，决定密钥能调用哪些模型和协议，不同分组的线路和倍率可能不同。见 [分组与倍率说明](https://wiki.niceai.dev/guide/billing-groups)。

### 倍率

中转服务常用的计价方式：实际扣费 = 按官方价格计算的费用 × 倍率。倍率以控制台显示为准。

### 额度

账户余额的计量单位。NiceAI 充值 ¥1 到账 1 额度，按实际用量扣除。

## 错误相关

### 401 / 403 / 404 / 429 / 529

最常见的几个 HTTP 错误码，分别对应认证失败、无权访问、地址或模型不存在、请求过于频繁、上游过载。见 [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)。

## 下一步

- [常见问题 FAQ](https://wiki.niceai.dev/guide/faq)
- [快速开始](https://wiki.niceai.dev/guide/quick-start)
