大模型 API 接入术语表

先把字段和协议分清楚，再处理具体客户端配置。

本页只解释相对稳定的技术概念。模型名称、价格、上下文和开放状态会变化，请以控制台、价格页和接口实时返回为准。

连接与认证

决定请求发往哪里、使用谁的权限以及调用哪个模型。

Base URL: 客户端发送 API 请求时使用的基础地址。AI快站的 OpenAI Compatible Base URL 为 https://www.aifast.club/v1；如果客户端会自动追加 /v1，需要根据最终请求地址调整。
查看相关教程
Endpoint接口端点: 在 Base URL 后用于执行具体操作的路径，例如 /models、/chat/completions 或 /responses。不同端点的请求体和返回结构可能不同。
API Key: 用于识别账号和授权请求的密钥。应保存在服务端环境变量或密钥管理系统中，不能写入网页前端、公开仓库、截图或公开日志。
查看相关教程
Bearer 认证Bearer Authentication: 常见的 HTTP 认证方式。请求头通常写为 Authorization: Bearer YOUR_API_KEY；重复添加 Bearer 或遗漏空格都可能导致 401。
模型 IDModel ID: API 请求中 model 字段需要填写的机器可读标识，不一定等于网页上的中文名称或模型系列名。应通过控制台或 /v1/models 获取当前账号可用的真实值。
查看相关教程

决定请求和响应采用什么结构，以及客户端能使用哪些能力。

OpenAI Compatible: 表示接口在地址、认证或请求结构上兼容 OpenAI SDK 的一部分能力，不等于所有模型、端点、工具调用和多模态功能都完全一致。
查看相关教程
Chat Completions API: 以 messages 数组组织对话内容的常见文本生成接口。接入前仍需确认目标模型是否支持流式输出、工具调用、图像输入等扩展能力。
Responses API: 使用 input、output 和事件流组织请求与响应的接口形态。Codex 等客户端可能依赖该接口，不能仅凭 Chat Completions 调用成功就判断完全兼容。
查看相关教程
SSEServer-Sent Events: 服务器通过一个持续的 HTTP 连接分段发送事件的机制。大模型流式输出常使用 SSE，客户端需要逐块解析 data 字段并处理连接中断。
查看相关教程
工具调用Tool Calling: 模型返回结构化参数，由应用决定是否执行函数、搜索、文件或其他外部工具。普通文本成功不代表工具调用链路一定兼容。

决定请求在高并发、异常和成本压力下是否仍然可控。

Token: 模型处理文本时使用的计量单位。输入、输出、缓存和推理 Token 可能采用不同统计方式，真实用量应以响应 usage、控制台账单和价格页为准。
查看相关教程
上下文窗口Context Window: 一次请求可处理的输入、历史消息和输出的总容量边界。超过模型或兼容层限制时，可能返回 400、截断内容或导致延迟明显增加。
限流Rate Limit: 服务对请求频率、并发量或用量设置的限制。收到 429 后应先检查配额和并发，再进行有上限的指数退避。
查看相关教程
超时Timeout: 请求在连接、读取或总任务阶段超过客户端允许时间。流式生成和 Agent 工具任务通常需要分别设置读取超时和任务总时限。
指数退避Exponential Backoff: 重试间隔逐次增加的策略，例如等待 1、2、4 秒并设置最大次数。适合部分 429、5xx 和短暂网络错误，不适合认证或参数错误。
请求 IDRequest ID: 用于定位单次请求的标识。排错时应同时记录请求 ID、时间、模型 ID、状态码和脱敏后的错误正文。