🤖 AI 摘要
选择 AI API 中转站时,不要只看价格。更应该检查 Base URL 是否标准、API Key 是否可控、模型权限是否清楚、错误是否透传、是否能查看用量日志和 raw quota、长请求是否有独立通道,以及遇到空回复、超时或工具调用异常时是否有明确处理机制。Link-AI 提供 api1 / api2 双通道、标准 OpenAI-compatible 端点、扣费检测和用量排查入口。
💡 直接答案
选择 AI API 中转站时,不要只看价格。更应该检查 Base URL 是否标准、API Key 是否可控、模型权限是否清楚、错误是否透传、是否能查看用量日志和 raw quota、长请求是否有独立通道,以及遇到空回复、超时或工具调用异常时是否有明确处理机制。
为什么不能只看价格?
很多用户在选 API 中转站时,第一反应是找最便宜的。但价格只是最表面的维度,便宜往往伴随着看不见的风险:
- 便宜不等于稳定:利润空间小意味着渠道质量差、运维投入少,故障频率高
- 没有用量日志、错误透传、模型权限说明时,用户很难判断问题发生在哪里:是模型质量差、渠道混入、还是自己的 prompt 有问题?
- 对 Claude Code、Cursor、Codex 这类 agent 工具,稳定性、长请求、工具调用兼容性比单次价格更重要:一次 524 超时导致的上下文丢失,可能比省下的 0.01 元更费时
不攻击同行,只讲判断维度。价格低但扣费不透明、售后缺失、工具调用兼容性差的中转站,长期使用成本往往更高。
选 API 中转站的 7 个核心维度
| 维度 | 为什么重要 | 用户应该怎么检查 | LinkAI 相关能力 |
|---|---|---|---|
| Base URL 是否标准 | 影响客户端兼容性、请求路径是否正确 | 确认是 /v1 结尾的 API 端点,不是控制台、注册页或文档页 | 标准 OpenAI-compatible API 端点,支持 api1 / api2 区分 |
| API Key 是否可控 | Key 一旦泄露,高余额账户可能被滥用 | 能否随时创建、禁用、删除 Key;排查时是否只需提供后四位 | 控制台支持 Key 管理;提供 token 名称标识 |
| 模型权限是否清楚 | 403 / 404 常见于权限不足或模型名写错 | 是否清楚说明哪些模型可用;403/404 是否有明确提示 | 提供中文文档和模型权限说明 |
| 错误是否透传 | 401/403/404/429/503/524 排查方向不同,有 request_id 才能追溯 | 出错时是否返回可读错误信息和 request_id | 提供 request_id 排查入口 |
| 能否查 usage log / raw quota | 判断扣费是否透明、是否有异常消耗 | 是否能查看请求前后的 raw quota 变化 | 提供扣费检测工具和 raw quota 查询 |
| 是否支持长请求通道 | Claude Code、Codex 类任务容易触发 524/503 | 是否有独立长请求通道,而非所有请求混在同一队列 | 提供 api2 直连通道,减少长请求超时 |
| tool_calls / function_call 是否兼容 | Agent 工具依赖工具调用;处理不当会把内部调用当文本显示 | 是否能正确处理 OpenAI-compatible tool_calls 和 Responses API function_call | 兼容 OpenAI-compatible 工具调用格式 |
Base URL 和 OpenAI-compatible 兼容性
配置 API 中转站时,Base URL 是最基础也是最容易填错的字段。
普通请求
https://api1.link-ai.cc/v1
适合普通聊天、快速问答、LobeChat、NextChat 等场景。
长请求、长上下文、Claude Code / Codex 类任务
https://api2.link-ai.cc/v1
适合任务时间长、上下文长、涉及工具调用的 agent 场景。
⚠️ Base URL 必须是 API 端点
Base URL 必须是 API 端点,不是控制台地址、不是注册链接、不是文档页面。填错了会收到 404 或 no available channel。
OpenAI-compatible 不代表每个客户端字段完全一样。 Claude Code、Codex、Cursor、Continue、Cline、NextChat 仍需分别确认 provider 字段和模型名。
相关配置参考:
API Key 与权限安全
API Key 是访问 API 的凭证,安全性至关重要。以下是日常使用中的建议:
- 用户应该能随时创建、禁用、删除自己的 API Key:如果 Key 管理功能缺失,说明平台在安全管控上有不足
- 不要把长期高余额 Key 放到不可信客户端:测试环境、本地开发机、共享机器都有泄露风险
- 排查时只提交 Key 后四位或 token 名称,不要提交完整 Key:完整 Key 可能被日志系统记录,存在二次泄露风险
- 如果怀疑泄露,应立即删除旧 Key 并生成新 Key:不要试图"修改"Key,生成新 Key 后旧 Key 应该立即失效
📌 关于"Key 泄露"和"绝对安全"
任何平台都无法承诺 Key "绝对不会泄露"。用户应采用最小权限原则(只授权必要模型的访问权)、使用可撤销 Key(定期更换或发现问题立即撤销)。平台能做的是提供完善的 Key 管理机制,而不是保证零泄露。
模型权限和模型名透明度
中转站应该让用户清楚自己能用哪些模型。常见的权限相关错误:
- 403 权限不足:API Key 没有该模型的访问权限,常见于用户分组限制了可用模型
- 404 / model not found:模型名写错,或当前分组未开通该模型
收到 403 或 404 时,建议:
- 检查控制台中的用户分组和模型权限
- 确认模型名拼写正确(注意大小写和版本号)
- 参考 Codex CLI invalid_api_key 排查 和 AI 编码工具 Base URL 配置
错误透传与 request_id
API 中转服务应该尽量保留上游错误信息,或给出可排查的 request_id。
常见错误码及排查方向
| 错误码 | 含义 | 常见原因 |
|---|---|---|
| 401 | 认证失败 | API Key 无效、未设置、格式错误 |
| 403 | 权限不足 | Key 没有该模型访问权限、用户分组限制 |
| 404 | 未找到 | Base URL 路径错误、模型名不存在或拼写错误 |
| 429 | 请求过多 | 触发限速,等一会再试 |
| 503 | 上游不可用 | 渠道异常、模型暂不可用、路由失败 |
| 524 | 网关超时 | 任务太长、响应太慢,建议换 api2 通道 |
用户反馈问题时,应提供:
- request_id
- 请求时间
- 模型名
- 客户端(Claude Code / Codex / Cursor / NextChat)
- API Key 后四位或 token 名称
扣费透明、raw quota 和 usage log
用户需要能判断一次请求是否产生用量。以下是判断扣费透明度的关键数据:
- prompt_tokens:输入 token 数,通常一定会产生费用
- completion_tokens:输出 token 数,是判断输出质量的依据
- raw quota:请求前后 quota 的实际差值,反映真实消耗
- usage log:每次请求的详细用量记录
💡 空回复时怎么判断扣费是否合理?
如果 completion_tokens=0 且没有 tool_call、没有图片、没有音频、没有搜索产物,不应按成功输出最终扣费。如果已预扣,应在最终结算阶段返还。