API 基础地址

详细解释

Base URL（基础地址，也叫 API Endpoint Prefix） 是客户端 SDK 初始化时必填的第一个参数（或者第二个，紧跟着 API Key）。它决定了你的所有 HTTP 请求最终打到哪个域名、哪个版本前缀下。

以一个完整请求 URL 为例：

https://api.weimeta.cn/v1/chat/completions
└────────────────────┘└──┘└──────────────────┘
       Base URL       版本    具体 endpoint

90% 的接入方第一次接 API 时踩过的坑：

1. 漏写 /v1：把 Base URL 填成 https://api.weimeta.cn，SDK 最后拼成 https://api.weimeta.cn/chat/completions，返回 404，然后怀疑 Key 有问题。
2. 多写一个斜杠：Base URL 填 https://api.weimeta.cn/v1/，SDK 内部再拼 /chat/completions → v1//chat/completions，部分反向代理对双斜杠敏感。
3. 用错了厂商：把 OpenAI SDK 的默认 https://api.openai.com/v1 直接带到另一家厂商，报 401 还不知道为什么。
4. http vs https：部分老代码库写了 http://，现代 API 几乎全部要求 HTTPS。

所有 OpenAI 兼容接口 都会告诉你一个 Base URL，只要把 OpenAI SDK 的 base_url 参数改掉即可零代码迁移。

主流厂商 Base URL 速查（2025 年公开档）

在 SDK 中的正确写法（三种语言）

# Python — openai>=1.0 新 SDK
from openai import OpenAI
client = OpenAI(
    api_key="wm-xxxxxxxx",
    base_url="https://api.weimeta.cn/v1"  # ✅ 不要漏 /v1，末尾不要带 /
)

// Node.js — openai v4+
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "wm-xxxxxxxx",
  baseURL: "https://api.weimeta.cn/v1" // 注意 Node SDK 是大写 URL
});

# cURL — 直接拼
curl https://api.weimeta.cn/v1/chat/completions \
  -H "Authorization: Bearer wm-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "model": "gpt-4o-mini", "messages": [] }'

常见问题