> ## 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

> 由于 api.laozhang.ai 受到 DNS 攻击及污染影响，老张API默认域名已切换为 api2.laozhang.ai。API Key、接口路径、参数和调用方式无需修改。

* **发布日期**：2026年7月23日
* **最后核对**：2026年7月23日
* **当前状态**：`api2.laozhang.ai` 已启用并成为文档默认域名；`api-vip.laozhang.ai` 与 `api-cf.laozhang.ai` 可作为备用线路

由于旧域名 `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}
curl https://api2.laozhang.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.6-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

### Python SDK

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

client = OpenAI(
    api_key="YOUR_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/v1/videos
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快速开始](/getting-started)
* [OpenAI SDK 接入指南](/api-capabilities/openai-sdk)
* [模型信息与选型指南](/api-capabilities/model-info)
* [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)