LaoZhang API 首次调用前怎么核对？
简答：LaoZhang API 首次接入不要直接照抄旧教程：截至 2026 年 11 月 1 日，公开页面可确认主产品站使用 laozhang.cfd，页面列出的 API 基础地址为 api.laozhang.cfd/v1，并提供 api2.laozhang.cfd 备用域名与 api-vip.laozhang.cfd 优化域名。最稳妥的顺序是：先从当前产品页进入控制台，再复制 Key、Base URL、模型 ID 和请求路径；其中具体注册流程、接口路径与权限仍应以当前控制台或文档为准。
定义：LaoZhang API 是一个由 YingTu Technology Pte. Ltd. 运营的第三方 AI API 网关和路由服务，不是上游模型厂商的官方 API。
先看三步速查：不要把不同域名混着用
本文是独立的 AI API 接入指南，不是 LaoZhang API 官方站。本文只解决一个问题：你已经准备开始接入时，如何确认应该使用哪个域名、哪个 Key、哪个 Base URL，以及哪些参数不能凭旧文章猜测。
| 用途 | 当前公开页面可确认的信息 | 使用前动作 |
|---|---|---|
| 产品说明与入口 | laozhang.cfd | 从当前页面进入控制台或文档，不要从搜索结果中的旧链接直接注册 |
| 主 API 地址 | https://api.laozhang.cfd/v1 | 发送请求前重新打开当前页面，确认地址没有变化 |
| 备用 API 地址 | api2.laozhang.cfd | 仅在主地址连接失败或超时时切换，并保留原请求格式 |
| 优化地址 | api-vip.laozhang.cfd | 先确认所在区域和账号权限，不能把“优化”理解为固定可用 |
| 状态页 | api.laozhang.ai/uptimeStatus | 只作为公开状态参考，不能替代自己的请求日志和错误响应 |
产品中文页面明确列出了主 API 地址、备用地址和优化地址；状态页则显示了多个 API 接口和模型的探测结果。由于不同域名的页面用途并不完全相同，本文不把 api.laozhang.ai 与 api.laozhang.cfd 直接判定为同一套当前入口。二者的对应关系应以控制台或最新文档为准。
可先查看当前中文产品页面和公开状态页，再复制实际参数。
Key、Base URL、模型和路径：四项分别核对
- 确认 Key 来源。
API Key 应从当前控制台的账号或令牌管理页面创建或复制。公开条款说明，用户需要负责保护 API Key、访问令牌和集成密钥；如果怀疑泄露，应及时处理撤销、轮换或限制。不要把完整 Key 写入浏览器前端、公开仓库、截图、工单或诊断日志。可以只检查环境变量是否存在，不打印完整值。
- 确认 Base URL。
当前公开中文页面列出的 API 基础地址是
https://api.laozhang.cfd/v1。这里的/v1是否由客户端自动拼接，取决于你使用的 SDK 或工具。若客户端配置项名称是“Base URL”，通常应填写文档给出的基础地址；若配置项要求“Endpoint”，则要按照该客户端的说明判断是否需要完整路径。 - 确认模型 ID。
状态页在 2026 年 11 月 1 日抓取时列出了
gpt-5.4-mini，并显示该页面的探测结果为 100%。这只能证明状态页当时列出了该模型和探测结果，不能证明你的账号、区域或令牌一定有权限调用。模型 ID、权限和可用协议仍需在控制台或模型页面逐项核对。 - 确认请求路径。
本次可抓取的公开产品页能够确认基础地址，但没有提供可直接核验的完整 Chat Completions 路径、请求字段和账号权限说明。因此不要把旧文章中的
/chat/completions、模型名或请求头直接视为当前固定规则；发送前应从当前文档复制完整路径。
关键结论：当前资料足以核对域名层级和部分模型线索，但不足以把完整请求路径、认证头、模型权限和响应字段写成 LaoZhang API 的长期固定事实。缺少对应官方页面时，应标记为“需核实”，而不是用通用 OpenAI 兼容经验补全。
安全的最小核验模板：先确认参数，再发送请求
下面的模板用于避免误把旧参数发送到错误域名。它不会输出完整密钥，也不会把未经当前文档确认的请求路径伪装成固定值。运行前，请把 LAOZHANG_BASE_URL、LAOZHANG_PATH 和 LAOZHANG_MODEL 从当前控制台或文档复制后再填写。
export LAOZHANG_API_KEY='替换为控制台生成的 Key'
export LAOZHANG_BASE_URL='https://api.laozhang.cfd/v1'
export LAOZHANG_PATH='从当前文档复制完整请求路径'
export LAOZHANG_MODEL='从当前模型列表复制模型 ID'
test -n "$LAOZHANG_API_KEY" && echo 'API Key 已设置' || echo 'API Key 未设置'
printf '请求地址：%s%s\n' "$LAOZHANG_BASE_URL" "$LAOZHANG_PATH"
printf '模型：%s\n' "$LAOZHANG_MODEL"
确认四项都来自当前页面后，再按文档示例发送最小请求。请求体只保留必要字段，例如模型字段、单条用户消息和文档明确要求的请求头；暂时不要加入工具调用、复杂 JSON、多模态文件或流式参数。这样可以把“域名错误、路径错误、模型权限错误和参数错误”分开。
如果你已经从当前文档确认接口采用 OpenAI Chat Completions 路径，可将路径变量设置为文档给出的完整值，再使用类似下面的命令。示例值，发送前核实：
curl --fail-with-body --max-time 120 "$LAOZHANG_BASE_URL$LAOZHANG_PATH" -H "Authorization: Bearer $LAOZHANG_API_KEY" -H "Content-Type: application/json" -d '{"model":"替换为当前模型 ID","messages":[{"role":"user","content":"请只回复：连接成功"}]}'
如果当前文档没有明确给出该路径，不要直接执行这条命令。先完成参数核验，或向服务方索取当前接口说明。
四项成功判定：不要只看终端有没有输出
一次请求是否真正完成接入，至少要同时检查以下四项：
- 状态码：记录 HTTP 状态码。出现错误时继续查看响应体，不要只凭 401、403、404 或 429 的数字猜原因。
- 最终 URL：确认协议、域名、
/v1、请求路径和是否重复拼接。常见配置错误包括/v1/v1、遗漏路径或把控制台地址当成 API 地址。 - 响应字段：确认返回的是接口 JSON，而不是登录页、网关 HTML 或错误页面。具体字段应以当前接口文档为准，不能因为某个客户端采用某种字段结构，就推断所有模型协议都相同。
- 实际文本或结果：最小请求应返回可识别的文本或结构化结果。若使用流式请求，还要确认增量内容被完整拼接，并正确处理结束信号和连接中断。
建议记录脱敏后的状态码、响应字段名、请求耗时和错误类别，不记录完整 Authorization Header、API Key、Cookie 或真实业务内容。
遇到连接失败时，按证据顺序排查
| 顺序 | 检查证据 | 处理方式 |
|---|---|---|
| 1. 凭据 | 环境变量是否为空、Key 是否带空格或换行 | 重新复制 Key，只输出是否存在，不打印完整值 |
| 2. 最终地址 | 客户端日志中的完整 URL | 对照当前页面，确认没有把产品站、状态页或旧域名当作 API 地址 |
| 3. 路径 | 文档给出的完整接口路径 | 不要凭经验补全；确认是否需要 /v1 和具体资源路径 |
| 4. 模型 | 当前模型列表、账号权限和错误响应 | 重新复制模型 ID，确认该模型属于当前 Key 可用范围 |
| 5. 响应体 | 错误 JSON、响应头、请求 ID 和客户端日志 | 根据实际错误字段判断认证、权限、路径、参数、限流或上游问题 |
| 6. 备用域名 | 主域名是否连接失败或超时 | 按公开页面说明切换备用域名，并重新核对最终 URL |
公开产品页面说明，主 API 地址连接失败或超时时可以尝试备用 API 地址；这是一条域名切换建议，不等于所有错误都能通过换域名解决。若返回 401、403、404 或 429，应先查看响应体和账号权限，再决定是否切换地址。
如果需要了解错误码的通用定位顺序，可继续阅读API 返回 401 的 Key、请求头与 Base URL 排查方法；需要把已确认的兼容接口配置到工具中，可查看Dify OpenAI 兼容 API 配置教程或Continue OpenAI Compatible API 配置教程。
数据和生产使用前，至少确认这两条边界
公开隐私政策称，服务默认不保存 API Prompt、响应和上传内容，但会处理账号、计费、安全、用量、状态、延迟、IP 地址等必要服务元数据；请求内容还可能传输给上游模型提供商。政策同时说明，跨境处理地点和上游服务商的具体规则可能不同。
因此，首次调用可以使用不含个人信息、密钥、商业机密和真实客户数据的测试文本。正式接入前，应让团队单独核对上游处理、跨境传输、日志保留、账号权限和业务合规要求。相关边界可查看隐私政策和用户协议。本文不把默认不保存内容理解为“任何上游都不会保留或处理请求”。
常见问题
LaoZhang API 当前应该从哪个域名开始？
截至 2026 年 11 月 1 日，公开中文产品页面显示产品入口为 laozhang.cfd，并列出 api.laozhang.cfd/v1 作为 API 基础地址。注册和取 Key 前，建议从当前产品页面进入控制台；不要仅凭旧文章或搜索结果中的 api.laozhang.ai 链接判断当前入口。
api.laozhang.cfd、api2.laozhang.cfd 和 api-vip.laozhang.cfd 有什么区别？
公开产品页面将 api.laozhang.cfd 作为主 API 地址，api2.laozhang.cfd 作为连接失败或超时时的备用地址，并提到 api-vip.laozhang.cfd 面向部分欧美服务器直连场景。实际使用前仍应根据当前页面、区域和账号权限核对，不能把备用或优化地址理解为永久保证。
gpt-5.4-mini 可以直接调用吗？
状态页在 2026 年 11 月 1 日抓取时列出了 gpt-5.4-mini，并显示当时探测结果为 100%。这不等于你的 Key 一定有权限，也不等于该模型支持所有协议。应从当前模型列表或控制台复制模型 ID，并查看账号权限和接口要求。
为什么不能直接照抄 OpenAI 兼容接口的请求路径？
因为本次可核验的公开页面确认了基础地址，但没有提供足以证明当前完整请求路径、字段和权限的公开文档页面。应先从当前控制台或文档复制路径，再用最小请求测试；如果路径没有公开说明，应向服务方索取当前接口文档。
LaoZhang API 是否适合直接发送真实业务数据？
不应仅凭“默认不保存 API 内容”这一条声明直接下结论。隐私政策同时说明请求可能传输给上游模型和基础设施服务商，并涉及跨境处理。首次测试应使用脱敏数据，正式上线前再核对上游政策、数据授权、日志保留和适用法规。
相关阅读
参考资料
- LaoZhang API 中文产品页面：主 API、备用域名与接入说明
- LaoZhang API 公开状态页：接口与模型探测信息（api.laozhang.ai）
- LaoZhang API 用户协议：服务性质、Key、计费与上游责任
- LaoZhang API 隐私政策：内容处理、元数据与跨境传输