> ## 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 域名切换通知：默认接口改用 api2.laozhang.ai

> 2026 年 7 月 23 日老张API将默认域名切换为 api2.laozhang.ai；自 9 月 24 日起默认域名为 api.laozhang.ai，无法访问时再使用 api2.laozhang.ai。

* **发布日期**：2026年7月23日
* **最后核对**：2026年9月24日
* **当前状态**：已替代。自 2026 年 9 月 24 日起，默认 API 域名为 `api.laozhang.ai`；服务器在欧美、需要直连时可使用 `api-vip.laozhang.ai`；`api.laozhang.ai` 无法访问时改用 `api2.laozhang.ai`。当前的域名配置见[开发文档](/api-manual)，下文为 7 月 23 日发布时的说明。

由于旧域名 `api.laozhang.ai` 受到 DNS 攻击及污染影响，部分用户可能遇到域名无法解析、连接失败或请求超时。遇到这些问题时，请将请求域名替换为 `https://api2.laozhang.ai`；**API Key、接口路径、请求参数和调用方式均不需要修改**。

<Warning>
  如果当前调用出现域名无法解析、连接失败或请求超时，建议立即切换到 `api2.laozhang.ai`。不要通过关闭 HTTPS 证书验证、固定未知 IP 或使用不可信 DNS 来绕过连接问题。
</Warning>

## 应该使用哪个 API 域名？

| 域名 | 当前状态 | 推荐场景 | 重要限制 |
| - | - | - | - |
| `api2.laozhang.ai` | 已启用，文档默认 | 受影响网络及普通全球调用 | 新接入和现有项目迁移的首选域名 |
| `api-cf.laozhang.ai` | 已启用，Cloudflare 代理 | 全球备用线路、普通同步请求 | 源站默认约 120 秒未返回响应时可能出现 524 |
| `api-vip.laozhang.ai` | 已启用，欧美直连 | 欧美用户、不经 CDN 的调用和长耗时请求 | 无加速 CDN，亚洲用户获取响应可能较慢 |
| `api.laozhang.ai` | 旧域名，兼容保留 | 欧美服务器上当前仍可正常使用的调用 | 受 DNS 攻击及污染影响，可能无法解析或连接 |

## 如何完成切换？

只替换主机名，保留原来的协议、接口路径、请求体和 API Key。

### OpenAI 兼容接口

切换前：

```text theme={null}
https://api.laozhang.ai/v1/chat/completions
```

切换后：

```text theme={null}
https://api2.laozhang.ai/v1/chat/completions
```

最小请求示例：

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API密钥"

curl https://api2.laozhang.ai/v1/chat/completions \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.6-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

### Python SDK

先安装 `pip install openai`，并按上文设置 `LAOZHANG_API_KEY` 环境变量：

```python theme={null}
import os
from openai import OpenAI

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

### 环境变量

```bash theme={null}
export OPENAI_BASE_URL="https://api2.laozhang.ai/v1"
```

使用 Gemini 原生协议、图像、视频或余额查询接口时也只需替换域名。例如：

```text theme={null}
https://api2.laozhang.ai/v1beta/models/{model}:generateContent
https://api2.laozhang.ai/v1/images/generations
https://api2.laozhang.ai/wan/api/v1/services/aigc/video-generation/video-synthesis
https://api2.laozhang.ai/api/user/self
```

## Cloudflare 线路的 120 秒限制

`api-cf.laozhang.ai` 经过 Cloudflare 代理。Cloudflare 官方文档说明，默认 `Proxy Read Timeout` 为 120 秒；如果 Cloudflare 已连接源站，但源站在该时间内没有返回响应，可能出现 `524 A timeout occurred`。这不是 API Key 错误，也不一定表示任务在上游已经失败。

对于可能运行较长时间的图像、视频或复杂 Agent 请求，优先使用异步任务、轮询或流式响应，不要依赖单个长时间无响应的同步连接。`api-vip.laozhang.ai` 直接连接欧美服务器，不经过加速 CDN，因此不受 Cloudflare 默认 120 秒代理读取超时限制；但客户端、源站或其他负载均衡仍可能有自己的超时设置。

## 常见问题

### 切换域名后需要重新创建 API Key 吗？

不需要。原 API Key、模型 ID、接口路径、请求参数和计费账户保持不变，只需要替换请求 URL 中的域名。

### 欧美服务器必须马上切换吗？

不是。欧美服务器调用理论上不受影响，可以继续使用旧域名；但新项目和文档示例统一使用 `api2.laozhang.ai`。如果欧美服务器调用旧域名也出现异常，可以直接切换到 `api2.laozhang.ai` 或 `api-cf.laozhang.ai`。

### `api2.laozhang.ai` 可以打开控制台吗？

可以。控制台、模型价格和账户页面也已使用 `api2.laozhang.ai`，现有账户和登录信息不变。

### `api-cf.laozhang.ai` 的 120 秒是整个请求的固定时长吗？

准确说是 Cloudflare 到源站的默认读取超时：已连接源站后，如果约 120 秒没有收到响应，Cloudflare 可能返回 524。实际请求还会受到客户端、源站、负载均衡和具体接口超时配置影响。

### 长耗时请求应该选择哪个域名？

优先采用异步任务、轮询或流式响应。欧美用户或确实需要避开 Cloudflare 120 秒代理读取超时的同步请求可以使用 `api-vip.laozhang.ai`；亚洲用户通常优先使用 `api2.laozhang.ai`，因为海外直连线路没有 CDN 加速，响应可能更慢。

### 哪些用户适合使用 `api-vip.laozhang.ai`？

该域名适合欧美服务器、希望直连源站或需要避免 Cloudflare 代理读取超时的用户。它没有 CDN 加速，亚洲用户的网络往返时间和响应等待通常会更长；亚洲及普通调用仍建议优先使用 `api2.laozhang.ai`。

## 相关资料

* [老张API开发文档](/api-manual)
* [OpenAI SDK 配置](/api-manual#openai-sdk)
* [模型可用性与权限](/faq/model-availability)
* [Cloudflare：Error 524](https://developers.cloudflare.com/support/troubleshooting/http-status-codes/cloudflare-5xx-errors/error-524/)
* [Cloudflare：Connection limits](https://developers.cloudflare.com/fundamentals/reference/connection-limits/)
* [进入老张API控制台](https://api2.laozhang.ai/account/profile)


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