Base URL 与完整接口地址的区别
SDK 通常会在 Base URL 后追加 /chat/completions、/responses 或其他路径。如果把完整接口地址填进 Base URL,最终请求可能出现路径重复并返回 404。
正确:https://modbapi.com/v1
常见错误:https://modbapi.com/v1/chat/completions
最终接口:https://modbapi.com/v1/chat/completions不同工具的字段名称
Python SDK 常用 base_url,Node.js SDK 常用 baseURL,图形化客户端可能显示为 API Host、Endpoint 或 API 地址。无论名称如何,都应确认工具是否会自动追加 /v1。
出现 404 时的排查顺序
打印最终请求 URL,检查是否出现 /v1/v1 或 /chat/completions/chat/completions,再确认协议与路径是否匹配。不要通过不断尝试随机地址解决问题。
常见问题
关于OpenAI Base URL 配置与常见错误的常见问题
Base URL 是否必须包含 /v1?
OpenAI 兼容 SDK 通常需要,具体工具如会自动追加则按其说明配置。
为什么地址正确仍然 404?
继续检查模型协议、最终拼接路径和反向代理规则。
浏览器打开 Base URL 没有页面正常吗?
正常,API 地址用于程序请求,不一定提供网页界面。