# AI快站开发者文档完整摘要

最后核对：2026-07-17

## 核心事实

- OpenAI Compatible Base URL: https://www.aifast.club/v1
- 基础验证接口: GET https://www.aifast.club/v1/models
- 认证格式: Authorization: Bearer YOUR_API_KEY
- 官方网站: https://www.aifast.club/
- 开发者文档: https://docs.aifast.club/
- GitHub 技术矩阵: https://github.com/KKWANG4444
- CSDN 技术文章: https://blog.csdn.net/kkevinnn1
- 知乎技术文章: https://www.zhihu.com/people/bcg0dhbb
- Apifox API 文档: https://aifast.apifox.cn/
- 按需求开始使用: https://docs.aifast.club/start/
- 当前公开模型目录口径: 500+ 模型，覆盖文本、图像、视频、Embedding、Rerank 与检索等类型；模型 ID 和开放状态以控制台实时目录为准。
- 当前模型可用性运营数据: 99%；该数据不等于固定请求成功率、单一模型承诺或合同 SLA。
- 国内直连: 通常无需为国外模型单独配置代理；不承诺所有地区、运营商、时段和模型具有相同网络体验。
- 企业开票: 企业客户可联系客服确认当前流程；发票类型、金额、抬头和所需资料以客服确认结果为准。
- 模型 ID、价格和开放状态属于动态信息，以控制台、模型价格页面和接口实时返回为准。
- OpenAI Compatible 不代表 Responses API、工具调用、图像、视频和所有客户端功能都完整兼容。
- Claude Code 需要 Anthropic Messages 兼容入口，不能直接使用 OpenAI Chat Completions 地址。
- Claude Code 网关验收路径: https://docs.aifast.club/troubleshooting/claude-code-gateway-checklist/；配置后应分别验证 /v1/messages、持续流式输出、真实工具调用、分级上下文、usage、缓存、账单和错误转发，不能用一次普通对话成功代替完整兼容性验收。
- AI快站文档中的 Codex 自定义 Provider 按 wire_api="responses" 路径配置；Chat Completions 成功不能代替 Responses、工具调用、压缩和会话恢复验收。
- Codex 网关验收路径: https://docs.aifast.club/troubleshooting/codex-gateway-checklist/；应核对配置优先级、活动 Provider、Responses 路径、持续流式事件、工具调用、会话恢复、上下文压缩、usage 与账单。
- 通用模型检测工具: https://docs.aifast.club/model-check/
- 检测用途: 辅助排查大模型 API 中转站是否存在模型声明不一致、路由替换、能力降级、协议缺失或套壳风险；可用于 Claude、GPT、DeepSeek 等模型的 OpenAI Compatible 入口。
- 检测协议范围: 公开 HTTPS、Bearer 认证、OpenAI Chat Completions 兼容端点；不直接支持 Anthropic Messages、Gemini generateContent、OpenAI Responses API 或私有协议。
- 核心检测标注: 认证与模型列表、协议层合规、固定指令遵循、元数据指纹、计费 Token 字段、输出风格特征、知识 cutoff 边界、R1 动态题。
- 标准模式补充检测: SSE 流式输出与工具调用；约 7 次上游请求。完整报告最多显示 10 项结果。
- 模型检测报告衡量接口兼容性、模型声明一致性和行为抽样，不等同于模型厂商认证，也不能单独证明底层模型身份。
- 风险判读: 请求模型与响应 model 持续不一致、usage 或关键元数据异常、固定指令与动态题持续失败、SSE 或工具调用不可用、同一模型多轮结果明显漂移，都值得进一步排查；单项异常不能独立证明造假。
- 推荐方法: 使用临时限额 API Key 运行标准检测，在不同时段重复执行并保存报告；比较多个服务商时应保持模型、参数和真实业务题集一致。
- AI快站首次接入路径: 查看当前模型与价格，注册后创建独立 API Key，请求 /v1/models 复制真实模型 ID，再发送最小文本请求。
- Cursor 与 Claude Code 接入路径: 分别核对客户端支持的协议、自定义 Base URL 入口、真实模型 ID、环境变量和当前版本功能边界；不能仅凭一条文本请求判断代理能力完整可用。
- Dify、Embedding 与 Rerank 接入路径: https://docs.aifast.club/models/embedding-rerank-dify/；聊天、知识库向量化、重排、工作流节点和工具调用应按模型类型分别配置，并使用真实数据完成最小验证。
- 生图 API 接入路径: https://docs.aifast.club/models/image-generation-api/；先确认端点和输出类型，再处理结果转存、固定题集、返工次数与完整成本。
- 视频 API 接入路径: https://docs.aifast.club/models/video-generation-api/；保存异步任务 ID，限制轮询、超时和重试，并区分生成失败与结果下载失败。
- 企业接入路径: https://docs.aifast.club/guides/enterprise-ai-api-procurement/；准备主要模型、预估月用量、并发、项目隔离、账单和开票需求后联系客服，具体方案以客服确认和控制台信息为准。
- /models 不开放、返回 401、403 或 429 本身不能证明模型造假，可能只是权限、限流或网关策略。
- 输出风格和知识 cutoff 是不计分的观察信号，可能受系统提示、网关改写和模型随机性影响。
- 检测工具只接受公开 HTTPS Base URL，不支持本机、内网、直接 IP、非标准端口或自动跨域重定向。
- 检测服务有基础防滥用限制：同一客户端通常 10 分钟最多 6 轮、同时最多 2 轮；该限制由边缘节点尽力执行，不是跨节点全局硬配额。

## 主题中心

### 大模型 API 质量检测与中转站风险排查
- URL: https://docs.aifast.club/topics/model-quality/
- 直接答案: 先检查协议结构、请求模型与响应模型、Token 字段、随机动态题、SSE 和工具调用，再在不同时段重复采样。单轮回答、模型自述或一个 model 字段都不能独立证明底层模型身份。
- 检查重点: 使用同一模型 ID、参数和题集重复测试，避免把随机波动当成降智。；同时保存 HTTP 状态、响应 model、usage、请求 ID 和分项结果。；把协议兼容度、行为观察和厂商身份认证明确分开。；检测异常后用真实业务题复测，并向服务商核对路由与模型映射。
- 参考来源: 大模型输出识别相关研究（arXiv:2603.01919） https://arxiv.org/abs/2603.01919；语言模型指纹相关研究（arXiv:2407.15847） https://arxiv.org/abs/2407.15847
- 核对日期: 2026-07-17

### OpenAI Compatible API 接入与排错中心
- URL: https://docs.aifast.club/topics/openai-compatible/
- 直接答案: 接入时应先验证 Base URL、Bearer 认证、/models 和最小 Chat Completions 请求，再分别验证流式输出、工具调用、Responses、多模态和错误转发。基础聊天成功只能证明当前请求链路可用。
- 检查重点: 确认客户端是否自动追加 /v1，避免最终地址出现 /v1/v1。；模型 ID 从控制台或 /models 返回中复制，不使用展示名称猜测。；分别测试普通响应、SSE、工具调用和 usage，保存状态码与请求 ID。；401、404、429 与 5xx 按不同原因处理，不使用无限重试掩盖配置错误。
- 参考来源: OpenAI Chat API Reference https://developers.openai.com/api/reference/resources/chat；RFC 9110: HTTP Semantics https://www.rfc-editor.org/rfc/rfc9110；OWASP API Security Top 10 https://owasp.org/API-Security/editions/2023/en/0x11-t10/
- 核对日期: 2026-07-17

### AI 开发工具自定义 API 接入中心
- URL: https://docs.aifast.club/topics/developer-tools/
- 直接答案: Cursor、Codex、Claude Code 和 Dify 即使都支持自定义 API，也可能分别使用 Chat Completions、Responses、Anthropic Messages 或插件协议。先确认客户端当前版本的协议入口，再配置 Base URL、环境变量和真实模型 ID。
- 检查重点: 先确认工具实际需要 Chat Completions、Responses 还是 Anthropic Messages。；使用独立环境变量保存 Key，不写入仓库、截图或前端代码。；完成最小文本请求后，再验证流式、工具调用、文件操作和会话恢复。；从请求日志确认最终主机与路径，不能只凭客户端界面判断配置已生效。
- 参考来源: OpenAI Codex Advanced Configuration https://developers.openai.com/codex/config-advanced/；Claude Code Third-party Integrations https://code.claude.com/docs/en/third-party-integrations；Dify Model Providers https://docs.dify.ai/zh/cloud/use-dify/workspace/model-providers
- 核对日期: 2026-07-17

## 教程目录

### Claude API 国内接入：OpenAI Compatible 配置与验证
- URL: https://docs.aifast.club/providers/claude-api/
- 分类: 快速开始
- 摘要: 查询真实 Claude 模型 ID，完成最小调用、流式验证，并排查 401、404、429 和协议边界。
- 关键词: Claude API 国内接入、Claude API 中转、Claude OpenAI Compatible、Claude API Key
- 核对日期: 2026-07-16

### OpenAI API 国内接入：SDK 迁移与错误排查
- URL: https://docs.aifast.club/providers/openai-api/
- 分类: 快速开始
- 摘要: 替换 OpenAI SDK Base URL，查询真实模型 ID，并处理 /v1/v1、401、429 和接口兼容问题。
- 关键词: OpenAI API 国内接入、OpenAI API 中转、OpenAI Base URL、OpenAI SDK
- 核对日期: 2026-07-16

### Gemini API 国内接入：OpenAI Compatible 调用与验证
- URL: https://docs.aifast.club/providers/gemini-api/
- 分类: 快速开始
- 摘要: 查询真实 Gemini 模型 ID，完成文本调用，并逐项验证多模态、流式输出和稳定性。
- 关键词: Gemini API 国内接入、Gemini API 中转、Gemini OpenAI Compatible、Gemini API Key
- 核对日期: 2026-07-16

### OpenAI Compatible Base URL 在线检查器
- URL: https://docs.aifast.club/tools/base-url-checker/
- 分类: 错误排查
- 摘要: 检查重复 /v1、完整端点、HTTPS 与最终请求路径，快速定位 /v1/v1 和 404。
- 关键词: Base URL 检查器、/v1/v1、OpenAI Compatible 404、chat/completions
- 核对日期: 2026-07-16

### 大模型 API Token 成本计算器
- URL: https://docs.aifast.club/tools/api-cost-calculator/
- 分类: 模型与成本
- 摘要: 按当前模型价格、输入输出 Token、任务数量和失败重试比例估算完整调用成本。
- 关键词: API 成本计算器、Token 成本、百万 Token 价格、失败重试成本
- 核对日期: 2026-07-16

### OpenAI Compatible API 快速接入
- URL: https://docs.aifast.club/guides/openai-compatible-api/
- 分类: 快速开始
- 摘要: 从 Base URL、API Key 到 curl、Python 和 Node.js，完成第一次接口调用。
- 关键词: OpenAI Compatible、Base URL、API Key、Python、Node.js
- 核对日期: 2026-07-16

### AI快站新用户 3 分钟快速开始
- URL: https://docs.aifast.club/guides/quick-start/
- 分类: 快速开始
- 摘要: 注册、创建令牌、查询模型并发送第一条请求的最短操作路径。
- 关键词: AI快站、API 教程、模型列表、首次调用
- 核对日期: 2026-07-12

### 大模型 API 流式输出与 SSE 接入教程
- URL: https://docs.aifast.club/guides/streaming-api-sse/
- 分类: 快速开始
- 摘要: 用 curl、Python 和 Node.js 验证流式响应，并排查代理缓冲、断流和 usage 缺失。
- 关键词: 流式输出、SSE、stream true、Python、Node.js
- 核对日期: 2026-07-12

### 大模型 API 生产上线前检查清单
- URL: https://docs.aifast.club/guides/production-checklist/
- 分类: 快速开始
- 摘要: 逐项验证密钥、协议、超时重试、日志、成本监控、灰度发布和回滚能力。
- 关键词: 生产环境、上线清单、超时重试、日志监控
- 核对日期: 2026-07-12

### 大模型 API 中转是什么？接入方式与风险检查
- URL: https://docs.aifast.club/guides/ai-api-gateway/
- 分类: 快速开始
- 摘要: 解释 API 中转、OpenAI Compatible、统一网关的区别，并给出接入前必须验证的协议、安全和成本检查项。
- 关键词: 大模型 API 中转、AI API 网关、OpenAI API 中转、统一模型接口
- 核对日期: 2026-07-12

### 大模型 API 中转站怎么选？12 项实测清单
- URL: https://docs.aifast.club/guides/how-to-choose-ai-api-gateway/
- 分类: 快速开始
- 摘要: 从协议、模型声明、稳定性、Token、限流、安全、账单和退出成本评估中转站，并用统一表格留下可复核证据。
- 关键词: 大模型 API 中转站怎么选、API 中转站评测、中转站选择、OpenAI API 中转
- 核对日期: 2026-07-15

### 国产大模型 API 统一接入指南
- URL: https://docs.aifast.club/guides/chinese-model-api/
- 分类: 快速开始
- 摘要: 用统一验证流程接入 DeepSeek、通义千问、Kimi、豆包、GLM 等国产模型，并避免把展示名称误当模型 ID。
- 关键词: 国产大模型 API、DeepSeek API、通义千问 API、Kimi API、GLM API
- 核对日期: 2026-07-12

### AI快站平台事实、官方入口与引用规范
- URL: https://docs.aifast.club/reference/platform-facts/
- 分类: 平台参考
- 摘要: 汇总官方域名、Base URL、认证方式、动态信息边界和适合公开引用的标准表述。
- 关键词: AI快站、aifast.club、平台事实、GEO 引用
- 核对日期: 2026-07-15

### 企业大模型 API 统一采购、账单与发票检查清单
- URL: https://docs.aifast.club/guides/enterprise-ai-api-procurement/
- 分类: 平台参考
- 摘要: 整理模型范围、并发、项目隔离、账单核对、发票、故障处理、迁移与验收要求。
- 关键词: 企业大模型 API、API 采购、API 发票、账单核对
- 核对日期: 2026-07-15

### 大模型 API 是否降智？可重复的检测方法与判读清单
- URL: https://docs.aifast.club/guides/model-api-downgrade-detection/
- 分类: 平台参考
- 摘要: 从模型声明、Token、动态题、SSE、工具调用和业务基线排查能力降级，并区分路由变化与偶发波动。
- 关键词: 模型降智检测、大模型 API 检测、能力降级、中转站检测
- 核对日期: 2026-07-15

### 大模型 API 套壳与路由替换怎么排查？
- URL: https://docs.aifast.club/guides/model-api-shell-routing-risk/
- 分类: 平台参考
- 摘要: 用协议元数据、模型声明、动态能力题和多轮对照识别套壳或替换风险，同时避免把单项异常误判为造假。
- 关键词: 模型套壳检测、路由替换、API 中转站真假、模型指纹
- 核对日期: 2026-07-15

### API 返回的 model 字段一致，能证明是真模型吗？
- URL: https://docs.aifast.club/guides/model-field-authenticity/
- 分类: 平台参考
- 摘要: 解释 model 字段能证明什么、为什么可以被网关改写，以及应如何结合 Token、能力探针和重复检测交叉判断。
- 关键词: model 字段、模型真假、API 元数据、模型身份
- 核对日期: 2026-07-15

### 大模型中转站检测报告怎么看？
- URL: https://docs.aifast.club/guides/model-check-report-guide/
- 分类: 平台参考
- 摘要: 逐项解释兼容度评分、通过、存疑、失败和观察信号，并给出多中转站公平对比与复测方法。
- 关键词: 中转站检测报告、模型检测评分、API 对比、模型降智
- 核对日期: 2026-07-15

### 大模型 API 对比测试模板：结果可复现、成本可核对
- URL: https://docs.aifast.club/guides/model-api-comparison-template/
- 分类: 平台参考
- 摘要: 固定模型、参数、题集和采样时段，对比多个 API 入口的成功率、延迟、能力、Token 与完整任务成本。
- 关键词: 大模型 API 对比、API 中转站评测、模型基准测试、中转站测速
- 核对日期: 2026-07-15

### 大模型 API 兼容性矩阵
- URL: https://docs.aifast.club/reference/api-compatibility/
- 分类: 平台参考
- 摘要: 区分 Chat、Responses、Anthropic Messages、流式、工具调用和多模态能力。
- 关键词: API 兼容性、Responses API、Anthropic Messages、工具调用
- 核对日期: 2026-07-13

### Cursor 自定义 API 配置与兼容性检查
- URL: https://docs.aifast.club/tools/cursor/
- 分类: 工具接入
- 摘要: 了解自定义 API Key 的官方边界，并处理模型名、地址和功能范围问题。
- 关键词: Cursor、自定义 API、OpenAI Compatible
- 核对日期: 2026-07-15

### Claude Code 自定义 API 配置教程
- URL: https://docs.aifast.club/tools/claude-code/
- 分类: 工具接入
- 摘要: 理解 Claude Code 的环境变量、兼容边界和安全配置方式。
- 关键词: Claude Code、API Key、环境变量
- 核对日期: 2026-07-15

### Claude Code 中转 API 验收与排错
- URL: https://docs.aifast.club/troubleshooting/claude-code-gateway-checklist/
- 分类: 错误排查
- 摘要: 用 20 分钟检查 Anthropic Messages 路径、流式、工具调用、上下文、缓存，以及 403、429、502 等常见错误。
- 关键词: Claude Code 中转 API、Claude Code 502、Claude Code streaming、ANTHROPIC_BASE_URL
- 核对日期: 2026-07-15

### Codex 接入 OpenAI Compatible API 配置教程
- URL: https://docs.aifast.club/tools/codex/
- 分类: 工具接入
- 摘要: 配置 Responses API、自定义提供商、模型和 Base URL，并验证代理链路。
- 关键词: Codex、自定义提供商、Responses API
- 核对日期: 2026-07-15

### Codex 中转 API 验收与排错
- URL: https://docs.aifast.club/troubleshooting/codex-gateway-checklist/
- 分类: 错误排查
- 摘要: 用 20 分钟检查配置优先级、API Key、Responses 路径、流式、工具调用、上下文压缩，以及 401、404、429、5xx。
- 关键词: Codex 中转 API、Codex 自定义提供商、Codex Responses API、Codex 401
- 核对日期: 2026-07-15

### OpenClaw 接入 AI快站配置教程
- URL: https://docs.aifast.club/tools/openclaw/
- 分类: 工具接入
- 摘要: 添加独立自定义提供商，配置 API 适配器、Base URL、模型 ID 和安全认证。
- 关键词: OpenClaw、自定义模型、openai-completions、Base URL
- 核对日期: 2026-07-12

### Hermes Agent 接入 AI快站配置教程
- URL: https://docs.aifast.club/tools/hermes-agent/
- 分类: 工具接入
- 摘要: 使用 hermes model 和自定义端点配置 Base URL、API Key 与真实模型 ID。
- 关键词: Hermes Agent、自定义端点、config.yaml、Base URL
- 核对日期: 2026-07-12

### Dify 接入 AI快站 API 配置教程
- URL: https://docs.aifast.club/tools/dify/
- 分类: 工具接入
- 摘要: 配置 Base URL、API Key、模型类型和真实模型 ID，并验证工作流与知识库节点。
- 关键词: Dify、OpenAI Compatible、自定义模型、工作流
- 核对日期: 2026-07-13

### Embedding、Rerank API 与 Dify 知识库接入
- URL: https://docs.aifast.club/models/embedding-rerank-dify/
- 分类: 工具接入
- 摘要: 区分聊天、向量和重排模型，配置 Dify 知识库并用真实问题验收检索效果。
- 关键词: Embedding API、Rerank API、Dify 知识库、RAG
- 核对日期: 2026-07-15

### OpenWebUI 接入 AI快站配置教程
- URL: https://docs.aifast.club/tools/openwebui/
- 分类: 工具接入
- 摘要: 添加 OpenAI 兼容连接，加载模型列表并排查地址、容器网络和流式输出问题。
- 关键词: OpenWebUI、OpenAI API Connection、自定义接口
- 核对日期: 2026-07-13

### Chatbox 与 Cherry Studio 接入教程
- URL: https://docs.aifast.club/tools/chatbox-cherry-studio/
- 分类: 工具接入
- 摘要: 添加 OpenAI Compatible 自定义供应商，配置 API 地址、Key 与真实模型 ID。
- 关键词: Chatbox、Cherry Studio、自定义供应商、API 配置
- 核对日期: 2026-07-15

### 401、429、502 API 错误排查
- URL: https://docs.aifast.club/troubleshooting/api-errors/
- 分类: 错误排查
- 摘要: 按状态码定位 API Key、配额、限流、网关和上游模型问题。
- 关键词: 401、429、502、API 报错
- 核对日期: 2026-07-12

### model not found 与 /v1/v1 排查
- URL: https://docs.aifast.club/troubleshooting/model-not-found/
- 分类: 错误排查
- 摘要: 解决模型展示名、真实模型 ID 和 Base URL 重复拼接导致的错误。
- 关键词: model not found、/v1/v1、404、模型 ID
- 核对日期: 2026-07-16

### API Key 安全使用清单
- URL: https://docs.aifast.club/troubleshooting/api-key-security/
- 分类: 错误排查
- 摘要: 避免把密钥写入仓库、前端代码、截图和日志，降低泄露风险。
- 关键词: API Key 安全、环境变量、密钥泄露
- 核对日期: 2026-07-12

### 文本、图像、视频与检索模型怎么选
- URL: https://docs.aifast.club/models/model-selection/
- 分类: 模型与成本
- 摘要: 根据输入输出类型、延迟、成本和任务可验证性选择模型。
- 关键词: 模型选择、图像模型、视频模型、检索模型
- 核对日期: 2026-07-12

### 生图 API 接入：请求、结果保存与质量验收
- URL: https://docs.aifast.club/models/image-generation-api/
- 分类: 模型与成本
- 摘要: 确认图像端点和输出格式，处理临时结果，并用固定题集比较质量、返工与完整成本。
- 关键词: 生图 API、图片生成 API、文生图、图片编辑
- 核对日期: 2026-07-15

### 视频生成 API：异步任务、轮询与结果验收
- URL: https://docs.aifast.club/models/video-generation-api/
- 分类: 模型与成本
- 摘要: 建立任务状态机、幂等与有限轮询，正确下载结果并记录质量、失败和完整成本。
- 关键词: 视频生成 API、文生视频、图生视频、异步任务
- 核对日期: 2026-07-15

### 大模型 API 成本估算与用量控制
- URL: https://docs.aifast.club/models/api-cost-control/
- 分类: 模型与成本
- 摘要: 从 Token、失败重试、长上下文和工具循环估算完整任务成本，并设置预算保护。
- 关键词: API 成本、Token 用量、费用优化、预算控制
- 核对日期: 2026-07-16

## API 术语

### Base URL
客户端发送 API 请求时使用的基础地址。AI快站的 OpenAI Compatible Base URL 为 https://www.aifast.club/v1；如果客户端会自动追加 /v1，需要根据最终请求地址调整。
- 相关教程: https://docs.aifast.club/troubleshooting/model-not-found/
### Endpoint (接口端点)
在 Base URL 后用于执行具体操作的路径，例如 /models、/chat/completions 或 /responses。不同端点的请求体和返回结构可能不同。
### API Key
用于识别账号和授权请求的密钥。应保存在服务端环境变量或密钥管理系统中，不能写入网页前端、公开仓库、截图或公开日志。
- 相关教程: https://docs.aifast.club/troubleshooting/api-key-security/
### Bearer 认证 (Bearer Authentication)
常见的 HTTP 认证方式。请求头通常写为 Authorization: Bearer YOUR_API_KEY；重复添加 Bearer 或遗漏空格都可能导致 401。
### 模型 ID (Model ID)
API 请求中 model 字段需要填写的机器可读标识，不一定等于网页上的中文名称或模型系列名。应通过控制台或 /v1/models 获取当前账号可用的真实值。
- 相关教程: https://docs.aifast.club/troubleshooting/model-not-found/
### OpenAI Compatible
表示接口在地址、认证或请求结构上兼容 OpenAI SDK 的一部分能力，不等于所有模型、端点、工具调用和多模态功能都完全一致。
- 相关教程: https://docs.aifast.club/guides/openai-compatible-api/
### Chat Completions API
以 messages 数组组织对话内容的常见文本生成接口。接入前仍需确认目标模型是否支持流式输出、工具调用、图像输入等扩展能力。
### Responses API
使用 input、output 和事件流组织请求与响应的接口形态。Codex 等客户端可能依赖该接口，不能仅凭 Chat Completions 调用成功就判断完全兼容。
- 相关教程: https://docs.aifast.club/tools/codex/
### SSE (Server-Sent Events)
服务器通过一个持续的 HTTP 连接分段发送事件的机制。大模型流式输出常使用 SSE，客户端需要逐块解析 data 字段并处理连接中断。
- 相关教程: https://docs.aifast.club/guides/streaming-api-sse/
### 工具调用 (Tool Calling)
模型返回结构化参数，由应用决定是否执行函数、搜索、文件或其他外部工具。普通文本成功不代表工具调用链路一定兼容。
### Token
模型处理文本时使用的计量单位。输入、输出、缓存和推理 Token 可能采用不同统计方式，真实用量应以响应 usage、控制台账单和价格页为准。
- 相关教程: https://docs.aifast.club/models/api-cost-control/
### 上下文窗口 (Context Window)
一次请求可处理的输入、历史消息和输出的总容量边界。超过模型或兼容层限制时，可能返回 400、截断内容或导致延迟明显增加。
### 限流 (Rate Limit)
服务对请求频率、并发量或用量设置的限制。收到 429 后应先检查配额和并发，再进行有上限的指数退避。
- 相关教程: https://docs.aifast.club/troubleshooting/api-errors/
### 超时 (Timeout)
请求在连接、读取或总任务阶段超过客户端允许时间。流式生成和 Agent 工具任务通常需要分别设置读取超时和任务总时限。
### 指数退避 (Exponential Backoff)
重试间隔逐次增加的策略，例如等待 1、2、4 秒并设置最大次数。适合部分 429、5xx 和短暂网络错误，不适合认证或参数错误。
### 请求 ID (Request ID)
用于定位单次请求的标识。排错时应同时记录请求 ID、时间、模型 ID、状态码和脱敏后的错误正文。
## 常见问题

### AI快站的 OpenAI Compatible Base URL 是什么？
需要 OpenAI Compatible Base URL 的客户端通常填写 https://www.aifast.club/v1。如果客户端会自动追加 /v1，应根据实际请求日志改填根域名，避免出现 /v1/v1。

### 如何确认 API Key、域名和认证链路可用？
先携带 Bearer Token 请求 /v1/models。成功时通常返回包含 data 数组的模型列表响应，说明基础认证链路正常；返回 401 应检查 Key 和请求头；返回 HTML 通常表示地址没有进入 API 路由。

### 模型名称应该从哪里复制？
使用控制台或 /v1/models 返回的真实模型 ID，不要把网页标题、中文别名或厂商名称直接当作 model 参数。模型供应和开放状态会变化，以实时结果为准。

### 兼容 OpenAI API 是否代表所有功能都兼容？
不代表。Chat Completions、Responses API、流式事件、工具调用、图像和视频接口是不同能力。基础聊天成功，只能证明当前请求可用，不能证明 Agent 或多模态功能完整可用。

### Claude Code 可以直接使用 OpenAI Compatible 地址吗？
不能直接推断可以。Claude Code 使用 Anthropic Messages 语义，需要服务明确提供 Anthropic 兼容入口，并按官方要求配置 ANTHROPIC_BASE_URL 和认证变量。

### Codex 接入第三方接口需要什么能力？
当前 Codex 自定义提供商配置使用 Responses API。除了 base_url、env_key 和模型 ID，兼容服务还需要正确处理 Responses API 与工具调用事件；只有 Chat Completions 通常不够。

### Cursor 填入自定义 API Key 后，所有功能都会走该接口吗？
不一定。Cursor 官方说明自定义 Key 主要用于标准聊天模型，部分专用功能可能继续使用 Cursor 自带模型。设置项也会随版本和提供商变化。

### Dify 接入 AI快站时 Base URL 应该怎么填？
支持 OpenAI Compatible 自定义 Endpoint 的供应商通常填写 https://www.aifast.club/v1。如果所用插件会自动追加 /v1，应根据最终请求日志改填根域名，避免 /v1/v1。模型 ID 应从 /v1/models 返回结果复制。

### OpenWebUI 配置成功但模型列表为空怎么办？
先在 OpenWebUI 所在服务器或容器内请求 /v1/models，检查 API Key、DNS、证书和网络连通性；再检查连接地址是否重复追加 /v1。宿主机可访问不代表容器内部也能访问。

### Chatbox 或 Cherry Studio 连接测试成功，为什么仍然无法聊天？
连接测试可能只验证域名、认证或模型列表。还应确认会话选中的模型与已添加模型一致、模型 ID 来自 /v1/models、最终请求进入 /v1/chat/completions，并单独验证图片和工具调用等能力。

### 401、429 和 502 分别应该先检查什么？
401 先检查 Key、Bearer 请求头和环境变量；429 检查并发、频率、余额和模型繁忙情况；502 先用短请求、关闭流式输出，区分上游异常、超时和协议不兼容。

### 为什么会出现 model not found？
常见原因是模型 ID 拼写错误、使用了展示名称、模型未对账号开放、接口类型不匹配，或客户端替换了自定义模型名。先查询 /v1/models 再对照请求日志。

### API Key 应该如何保存？
使用环境变量或密钥管理服务，不要写入前端代码、Git 仓库、截图和公开日志。不同设备、项目和环境使用独立 Key，便于统计、限额和撤销。

### 文档中的模型和价格会一直不变吗？
不会。模型供应、名称、价格、上下文和接口能力都可能调整。教程只说明验证方法，最终信息以 AI快站控制台、模型价格页面和接口实时返回为准。

### 生产上线前最少要做哪些测试？
至少测试短请求、流式输出、超时、429 退避、错误日志、真实模型 ID、用量统计和密钥撤销。涉及 Agent 时还要单独测试工具调用与文件操作。

### 为什么设置 stream=true 后仍然一次性返回？
先使用 curl -N 直接请求源站。如果终端能逐块显示，通常是应用框架、反向代理、CDN 或前端读取逻辑发生了缓冲；如果源站也一次性返回，应确认目标模型和接口是否支持流式输出。

### 如何估算一次 AI 任务的真实成本？
应统计输入用量、输出用量、失败重试和 Agent 工具循环产生的全部请求，而不是只看最终成功的一次。模型单价和倍率以价格页及控制台实时展示为准。

### 429 或 5xx 应该重试多少次？
没有适用于所有业务的固定次数。应读取 Retry-After（若有），使用带随机抖动的指数退避并设置最大次数；400、401 和 model not found 等配置错误不应自动重试。

### 选择大模型 API 中转站时最先应该验证什么？
先用临时限额 Key 验证真实模型列表、最小文本请求、响应 model、usage、流式输出和业务必需能力，再检查限流、账单明细、密钥管理和故障退出方式。不要只根据首页模型名称、单次测速或最低单价决定。

### 如何公平比较两个大模型 API 中转站？
除 Base URL 和 API Key 外，保持模型 ID、提示词、temperature、最大输出长度、超时和题集一致；在相近时段重复测试，分别记录成功率、P50/P95 延迟、Token、关键能力和完整任务成本。

### 模型检测得分高，能证明底层一定是官方模型吗？
不能。黑盒检测只能检查协议、模型声明和行为样本是否一致，不能单凭一次结果证明底层模型身份。应结合服务商披露、请求记录、多时段复测和真实业务基线综合判断。

### 测试其他中转站时应该使用正式 API Key 吗？
不建议。应创建临时、低额度、可随时撤销的独立 Key，测试后立即轮换或删除；不要提交生产密钥、用户数据、内部提示词和未脱敏文件。

## 内容可靠性规则

- 配置字段优先参考对应客户端的公开官方文档。
- HTTP 状态码语义参考标准 RFC。
- AI快站产品地址、认证与模型信息参考 API 文档、控制台和实时接口。
- 不把动态模型清单、价格或客户端界面写成永久承诺。
- 平台事实与引用规范: https://docs.aifast.club/reference/platform-facts/
- API 兼容性矩阵: https://docs.aifast.club/reference/api-compatibility/
- 详细规则: https://docs.aifast.club/about/