Base URL 与网关域名配置

为确保极致的网络连通性与高可用保障，XIMI-API 网关接入层部署了双主节点接入域名。您可以根据您的网络环境与客户端选择最合适的域名。

---

1. 网关节点列表

网关支持以下两个主域名地址：

节点名称	域名 Base URL	说明
服务节点 A (主用)	https://api.ximi-api.cc.cd/v1	全球加速主节点，延迟极低，推荐首选
服务节点 B (备用)	https://api.ximi-pro.xyz/v1	备用灾备高可用节点

---

2. 接口路径对应表

在使用不同的第三方工具、SDK 或自写 HTTP 请求时，请务必注意路径拼接规范：

请求类型 / 工具	对应填写的地址 / Base URL	说明
OpenAI SDK / 第三方客户端	https://api.ximi-api.cc.cd/v1	适用于 Python/Node SDK、Cursor、NextChat 等会自动拼接 /chat/completions 或 /images/generations 的工具
生图 API (完整 cURL / HTTP)	https://api.ximi-api.cc.cd/v1/images/generations	适用于直接发起 POST 请求的生图工具
异步生图 API (免超时)	https://api.ximi-api.cc.cd/v1/images/generations/async	适用于耗时较长、防防超时断连的生图任务
批量生图 API (Batches)	https://api.ximi-api.cc.cd/v1/images/batches	适用于千万级批量任务提交与导出打包

---

3. ⚠️ 常见路径配置避坑指南

请避免以下常见的路径配置错误：

1. ❌ 误填为首页路径：
   • 错误：https://api.ximi-api.cc.cd/（缺少 /v1）
   • 正确：https://api.ximi-api.cc.cd/v1
2. ❌ 多写前缀路径：
   • 错误：https://api.ximi-api.cc.cd/api/v1/chat/completions（请勿包含 /api）
   • 正确：https://api.ximi-api.cc.cd/v1/chat/completions
3. ❌ SDK 中重复拼接路径：
   • 错误：在 Python SDK 中设置 base_url="https://api.ximi-api.cc.cd/v1/chat/completions"
   • 原因：SDK 会自动在末尾拼接 /chat/completions，导致实际请求变为 .../chat/completions/chat/completions（404 错误）。