常见术语解释

本文适合

刚接触 AI API 的用户，帮助你理解文档中出现的各种术语。

基础概念

API（Application Programming Interface）

应用程序编程接口，简单说就是程序之间沟通的"语言"。

通过 API，你的程序可以向 AI 服务发送请求，获取 AI 的回复。

你的程序 → 发送请求 → API → AI 处理 → 返回结果 → 你的程序

API Key / 密钥 / 令牌

你的身份凭证，用于：

证明请求是你发的
从你的账户扣费

格式通常是：sk-xxxxxxxxxxxxxxxx

安全提示

API Key 就像密码，不要分享给任何人！

Base URL / 接口地址

API 服务的网址，所有请求都发送到这个地址。

51API 的 Base URL 是：

https://www.51api.org/v1

Token 相关

Token

AI 模型处理文本的最小单位，是计费的基础。

中文：约 1-2 个 Token/字
英文：约 1 个 Token/词

详细了解 Token →

输入 Token（Prompt Tokens）

你发送给 AI 的内容所消耗的 Token。

输出 Token（Completion Tokens）

AI 返回给你的内容所消耗的 Token。

max_tokens

限制 AI 回复的最大长度。设置这个参数可以控制成本。

python

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[...],
    max_tokens=500  # AI 最多回复 500 个 Token
)

模型相关

Model / 模型

AI 的"大脑"，不同模型有不同的能力和特点。

常见模型：

GPT-4o：OpenAI 的多模态模型
Claude：Anthropic 的模型，擅长长文和代码
Gemini：Google 的模型，性价比高
Grok：xAI 的模型，有联网能力

模型倍率

不同模型的价格系数。倍率越高，价格越贵。

模型	倍率	说明
gemini-2.5-flash	0.4x	便宜
gpt-4o	1x	标准
gpt-5	1.5x	较贵

补全倍率

部分高级模型的输出 Token 额外倍率。

例如 gpt-5-thinking 的补全倍率是 6x，意味着输出 Token 的费用是普通模型的 6 倍。

分组 / Group

令牌的归属类别，决定可以调用哪些模型。

分组	可用模型	分组倍率
gpt	GPT 系列	1x
claude	Claude 系列	1.2x
gemini	Gemini 系列	1.4x
grok	Grok 系列	1x

请求相关

Request / 请求

你的程序向 API 发送的数据包，包含你的问题和参数。

Response / 响应

API 返回给你的数据包，包含 AI 的回答和使用信息。

messages / 消息列表

对话的历史记录，包含所有的对话内容。

json

[
  {"role": "system", "content": "你是一个助手"},
  {"role": "user", "content": "你好"},
  {"role": "assistant", "content": "你好！有什么可以帮你？"},
  {"role": "user", "content": "今天天气怎么样？"}
]

role / 角色

消息的发送者类型：

角色	说明
`system`	系统指令，设定 AI 的行为
`user`	用户（你）的消息
`assistant`	AI 的回复

Stream / 流式输出

AI 回复时边生成边返回，实现"打字机"效果。

不开启流式：等 AI 全部生成完才返回开启流式：一个字一个字地返回，体验更好

高级概念

temperature / 温度

控制 AI 回复的随机性：

值	效果
0	最确定，每次回答几乎相同
1	默认，平衡创意和准确性
2	最随机，回答更有创意但可能不准确

top_p / 核采样

另一种控制随机性的参数，通常和 temperature 二选一使用。

Function Calling / 函数调用

让 AI 调用你定义的函数，实现与外部系统交互。

例如：让 AI 调用天气 API 获取实时天气。

Embedding / 嵌入

将文本转换成数字向量，用于：

语义搜索
文本相似度比较
推荐系统

Fine-tuning / 微调

用你自己的数据训练模型，让它更适合特定任务。

错误相关

401 Unauthorized

认证失败，通常是 API Key 错误或过期。

403 Forbidden

权限不足，通常是令牌分组不包含该模型。

404 Not Found

地址错误，通常是 Base URL 没有加 /v1。

429 Too Many Requests

请求过于频繁，需要降低请求频率。

500 Internal Server Error

服务器错误，稍后重试即可。

SDK 相关

SDK（Software Development Kit）

软件开发工具包，封装好的代码库，让你更方便地调用 API。

例如 OpenAI 的 Python SDK：

python

from openai import OpenAI
client = OpenAI(...)

OpenAI 兼容

51API 完全兼容 OpenAI 的 API 格式，意味着：

可以直接使用 OpenAI 的 SDK
只需要改 Base URL 和 API Key
不需要修改其他代码

常见术语解释 ​

基础概念 ​

API（Application Programming Interface） ​

API Key / 密钥 / 令牌 ​

Base URL / 接口地址 ​

Token 相关 ​

Token ​

输入 Token（Prompt Tokens） ​

输出 Token（Completion Tokens） ​

max_tokens ​

模型相关 ​

Model / 模型 ​

模型倍率 ​

补全倍率 ​

分组 / Group ​

请求相关 ​

Request / 请求 ​

Response / 响应 ​

messages / 消息列表 ​

role / 角色 ​

Stream / 流式输出 ​

高级概念 ​

temperature / 温度 ​

top_p / 核采样 ​

Function Calling / 函数调用 ​

Embedding / 嵌入 ​

Fine-tuning / 微调 ​

错误相关 ​

401 Unauthorized ​

403 Forbidden ​

404 Not Found ​

429 Too Many Requests ​

500 Internal Server Error ​

SDK 相关 ​

SDK（Software Development Kit） ​

OpenAI 兼容 ​

还有疑问？ ​