跳到主要内容

Base URL

通用请求说明 (Base URL & 鉴权)

在发起 API 请求之前，请了解我们平台针对不同业务线的全局网络端点（Base URL）以及标准的鉴权方式。

1. 基础请求地址 (Base URL)​

为了保障底层计算资源的物理隔离与极速响应，菜ai 为"AI 大模型"与"搜索阅读"分配了不同的独立端点。请根据您调用的产品选择对应的 Base URL。

1.1 AI 大模型 API 端点 (用于调用文本、图像、视频模型)​

无论您是集成到第三方工具（如 ClaudeCode、OpenClaw），还是在服务器上发起代码请求，我们强烈建议您默认使用以下全局主端点。该节点会自动为您分配最佳的国际专线路由：

https://cloud.ai.liandxu.cn

特定区域/备用节点 (高级选项) 如果遇到默认节点被企业防火墙拦截等特殊网络情况，可尝试替换为以下备用节点（您的 AI 大模型 Key 在以下节点均有效）：

节点类型Base URL适用场景说明
硅谷直连https://cloud.ai.liandxu.cn推荐默认使用，极速稳定。
CN2 跨境专线https://cloud-cn.ai.liandxu.cn针对特定复杂网络环境的 CN2 跨境优化线路。
香港中转节点https://cloud-hk.ai.liandxu.cn适合部署在亚太地区（非大陆）的服务器使用。

提示： 在大多数 AI 客户端（如 Chatbox）或编程插件中，只需将 Base URL 或 API Endpoint 字段填写为上述地址即可（注：部分插件可能要求在末尾补全 /v1，请视具体插件提示而定）。

1.2 搜索与阅读 API 端点 (用于联网搜索、文档解析)​

当您调用 /v1/search、/v1/reader 等专用的数据获取接口时，请务必使用以下独立端点：

https://api.ai.liandxu.cn

(注意：调用此端点时，必须搭配在"搜索阅读产品"版块生成的专属 API Key 使用)

2. API 鉴权 (Authentication)​

菜ai 全局接口均支持 HTTP 和 HTTPS，并采用行业标准的 Bearer Token 方式进行权限校验。

您需要在每一个 HTTP 请求的 Header 中携带您对应的 API Key。

Header 格式示例：

Authorization: Bearer 您的_API_KEY

(注意：Bearer 和您的 Key 之间必须有一个空格)

3. 数据格式 (Content-Type)​

除了特定说明的接口（如文件上传），我们在请求和响应中均使用 JSON 格式。请确保在您的请求 Header 中包含：

Content-Type: application/json

下一步步骤​

现在您已经掌握了对应产品的 Base URL 和鉴权方式，接下来您可以：