基本概念 - API地址 🌐

API 地址是你的程序实际请求的接口入口。

API 地址的作用

API 地址用于告诉程序请求应该发送到哪里。We-AI 收到请求后，会根据令牌、接口路径和平台规则完成后续处理。

一个典型的调用流程如下：

用户应用 -> we-ai API 地址 -> OpenAI/Claude

Base URL

在接入 SDK 或接口调用工具时，经常会看到 base_url、baseURL 或 API_BASE_URL 这样的配置项。它们通常表示 API 的基础地址。

示例（we-ai）：

https://we-ai.cc/v1

实际使用时，请将示例地址替换为平台提供的真实 API 地址。

请求路径

基础地址通常需要和具体接口路径组合使用。例如：

https://we-ai.cc/v1/chat/completions

其中：

• https://we-ai.cc/v1 是基础 API 地址。
• /chat/completions 是具体接口路径。

接入时需要检查

配置 API 地址时，建议检查：

• 协议是否正确，例如 https://。
• 地址末尾是否包含版本号，例如 /v1。
• SDK 中配置的是完整接口地址还是基础地址。
• 请求路径是否重复拼接了 /v1。

常见问题

为什么使用 we-ai 地址后请求失败？

常见原因包括 API 地址填写错误、令牌无效、请求路径重复、模型名称不支持、网络无法访问等。建议先使用最小请求进行测试，再接入完整业务代码。