OPENAI COMPATIBLE API

OpenAI 兼容 API base_url 检测

很多 API 中转服务会提供 OpenAI 兼容格式,但“能请求成功”不等于完全兼容。检测 base_url 时,应同时看端点格式、鉴权方式、模型列表、响应结构、错误码和计费记录。

01

检查 base_url 格式

常见 OpenAI 兼容 base_url 通常以 /v1 结尾,但不同 SDK 的配置方式可能不同。需要确认服务文档给出的地址是否能直接用于当前客户端。

02

检查模型和响应结构

先请求模型列表,再发送简单 chat 请求,检查返回字段是否接近 OpenAI 兼容格式,例如 id、object、choices、message、usage 等。

03

检查模型映射和扣费

部分服务会把用户请求的模型名映射到其他模型。检测时应关注实际返回、速度、上下文限制和扣费是否与文档一致。

Method

base_url 检测步骤

常见问题

base_url 能请求成功就说明兼容 OpenAI 吗?

不一定。还需要检查响应结构、stream 支持、usage 字段、错误码和具体 SDK 的兼容情况。

检测 base_url 时可以用正式 Key 吗?

不建议。首次测试应使用低权限、低额度、可删除的测试 Key,避免未知服务或日志带来的额外风险。

模型列表为空是不是服务不可用?

不一定。有些服务不开放模型列表端点,但仍支持指定模型请求,需要结合文档、chat 请求和错误响应一起判断。