提示 API Key 无效或 404，Base URL 该怎么填？

报 invalid_api_key 或 404 时，大多不是密钥本身坏了，而是请求没有发到老张API，或 Base URL 的路径拼错了。老张API的密钥只能配老张API的地址，各 SDK 的正确填法见下表。

项目	内容
OpenAI SDK Base URL	`https://api.laozhang.ai/v1`
Anthropic SDK Base URL	`https://api.laozhang.ai`（SDK 自动拼 `/v1/messages`）
Google Gen AI SDK	`base_url` 填 `https://api.laozhang.ai`，`api_version` 设为 `v1beta`
认证	`Authorization: Bearer 你的老张API密钥`
快速自检	`GET https://api.laozhang.ai/v1/models`

先看错误属于哪一类

现象	最常见原因	处理方法
`Incorrect API key provided: sk-...`	密钥是老张API的，地址仍是 `api.openai.com`	把 Base URL 改成 `https://api.laozhang.ai/v1`
401 且地址已经是老张API	密钥复制不完整、带了空格，或令牌已禁用、过期	重新复制密钥，到令牌管理确认令牌状态
404 Not Found	OpenAI SDK 漏了 `/v1`，或 Anthropic SDK 多加了 `/v1`	按上表核对路径
路径里出现 `//`	Base URL 末尾多了 `/`，或手动拼接时重复	去掉末尾斜杠，只让 SDK 拼接路径
SSL 或连接错误	漏写 `https://`，或当前网络到默认域名不通	补上 `https://`，必要时换用下文的备用域名

三种 SDK 的正确写法

不同 SDK 拼接路径的方式不同，所以 Base URL 不一样：OpenAI SDK 只在 Base URL 后面加资源名，需要自带 /v1；Anthropic SDK 会自己加 /v1/messages，再填 /v1 就会变成 /v1/v1/messages。

OpenAI SDK
Anthropic SDK
Google Gen AI SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LAOZHANG_API_KEY"],
    base_url="https://api.laozhang.ai/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["LAOZHANG_API_KEY"],
    base_url="https://api.laozhang.ai",  # 不要加 /v1
)

message = client.messages.create(
    model="glm-5.2",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(message.content[0].text)

import os
from google import genai

client = genai.Client(
    api_key=os.environ["LAOZHANG_API_KEY"],
    http_options={"base_url": "https://api.laozhang.ai", "api_version": "v1beta"},
)

response = client.models.generate_content(model="gemini-3.8-flash", contents="你好")
print(response.text)

运行前先设置环境变量 LAOZHANG_API_KEY。Anthropic 格式能调用哪些模型，见 Claude 协议中的可用模型说明。

用环境变量统一配置

很多工具读取 OpenAI 的标准环境变量。设置后，代码里可以不写 Base URL：

export OPENAI_API_KEY="你的老张API密钥"
export OPENAI_BASE_URL="https://api.laozhang.ai/v1"

如果改了地址仍然报同样的错，检查是否有多处配置互相覆盖：

代码初始化参数、.env 文件和系统环境变量各写了一个地址；
第三方客户端保存了旧的服务商配置；
程序没有重启，还在使用旧的环境变量。

第三方客户端一般在「自定义 API」或「OpenAI 兼容服务」里填写：API 地址 https://api.laozhang.ai/v1、API Key 填老张API密钥、模型名填模型与价格总表里的完整模型 ID。

用一条请求确认配置

curl https://api.laozhang.ai/v1/models \
  -H "Authorization: Bearer $LAOZHANG_API_KEY"

返回 data 数组说明密钥和地址都正确，数组里就是这个令牌能调用的模型。仍返回 401 时，到令牌管理检查令牌是否启用、是否过期、授权额度是否用完；必要时新建一个令牌再试。

备用域名

三个域名使用同一个 API Key，请求路径和参数相同，只换域名：

默认：api.laozhang.ai
服务器在欧美、需要直连：api-vip.laozhang.ai
api.laozhang.ai 无法访问时：api2.laozhang.ai

完整的接入步骤见老张API开发文档。

仍然无法解决时

把以下信息发给支持团队 hi@laozhang.ai：

请求时间和时区；
完整的请求地址（不含密钥）和使用的 SDK；
HTTP 状态码和完整错误正文；
密钥的前 6 位和后 4 位。

不要发送完整 API Key。密钥已经出现在聊天、截图或代码仓库里时，先按 API Key 管理撤销并换新。

使用指南

提示 API Key 无效或 404，Base URL 该怎么填？

先看错误属于哪一类

三种 SDK 的正确写法

用环境变量统一配置

用一条请求确认配置

备用域名

仍然无法解决时

相关文档

​先看错误属于哪一类

​三种 SDK 的正确写法

​用环境变量统一配置

​用一条请求确认配置

​备用域名

​仍然无法解决时

​相关文档

先看错误属于哪一类

三种 SDK 的正确写法

用环境变量统一配置

用一条请求确认配置

备用域名

仍然无法解决时

相关文档