外观
术语表
本页用一两句话解释使用 AI API 和中转服务时最常见的名词,按主题分组。
接入相关
API 中转
在用户和模型厂商之间转发 API 请求的服务。用户使用中转方提供的地址和密钥,按官方接口格式发请求,由中转方转发给上游模型并返回结果。
Base URL
客户端或 SDK 发送请求的根地址,客户端会在后面拼接具体接口路径。NiceAI 的 OpenAI 兼容地址是 https://api.niceai.dev/v1,Anthropic 协议地址是 https://api.niceai.dev。见 接口地址要不要加 /v1。
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 的区别。
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)
把重复使用的请求前缀缓存起来,后续请求命中时按更低单价计费、响应也更快。见 提示词缓存是怎么省钱的。
缓存命中
本次请求的前缀与之前缓存的内容完全一致,这部分 token 按缓存读取的价格计费。
分组
NiceAI 中密钥的归属类别,决定密钥能调用哪些模型和协议,不同分组的线路和倍率可能不同。见 分组与倍率说明。
倍率
中转服务常用的计价方式:实际扣费 = 按官方价格计算的费用 × 倍率。倍率以控制台显示为准。
额度
账户余额的计量单位。NiceAI 充值 ¥1 到账 1 额度,按实际用量扣除。
错误相关
401 / 403 / 404 / 429 / 529
最常见的几个 HTTP 错误码,分别对应认证失败、无权访问、地址或模型不存在、请求过于频繁、上游过载。见 常见错误码对照。