> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 老张API密钥报 invalid_api_key、401 或 404 时，多数是请求地址（Base URL）没有改成老张API或路径拼错。本页给出 OpenAI、Anthropic、Gemini 三种 SDK 的正确填法和排查顺序。

报 `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 | 密钥复制不完整、带了空格，或令牌已禁用、过期 | 重新复制密钥，到[令牌管理](https://api.laozhang.ai/token)确认令牌状态 |
| 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`。

<Tabs>
  <Tab title="OpenAI SDK">
    ```python theme={null}
    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)
    ```
  </Tab>

  <Tab title="Anthropic SDK">
    ```python theme={null}
    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)
    ```
  </Tab>

  <Tab title="Google Gen AI SDK">
    ```python theme={null}
    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)
    ```
  </Tab>
</Tabs>

运行前先设置环境变量 `LAOZHANG_API_KEY`。Anthropic 格式能调用哪些模型，见 [Claude 协议](/api-reference/claude)中的可用模型说明。

## 用环境变量统一配置

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

```bash theme={null}
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密钥、模型名填[模型与价格总表](/models)里的完整模型 ID。

## 用一条请求确认配置

```bash theme={null}
curl https://api.laozhang.ai/v1/models \
  -H "Authorization: Bearer $LAOZHANG_API_KEY"
```

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

## 备用域名

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

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

完整的接入步骤见[老张API开发文档](/api-manual)。

## 仍然无法解决时

把以下信息发给支持团队 [hi@laozhang.ai](mailto:hi@laozhang.ai)：

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

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

## 相关文档

* [老张API开发文档：配置请求地址](/api-manual)
* [API Key 如何创建、保存、轮换和撤销](/faq/token-management)
* [如何确认模型是否可用](/faq/model-availability)
* [Models API：获取模型 ID 列表](/api-reference/models)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.