AI快站 API 常见问题

答案优先,直接说明配置边界、验证方法和容易误判的地方。

接入AI快站的 OpenAI Compatible Base URL 是什么?

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

接入如何确认 API Key、域名和认证链路可用?

先携带 Bearer Token 请求 /v1/models。返回模型数组说明基础认证链路正常;返回 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 自带模型。设置项也会随版本和提供商变化。

错误排查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 等配置错误不应自动重试。