API 基础地址（Base URL）

💡 简介

本文档用于说明爱次元 API 的基础访问地址（Base URL）以及在不同网络环境下的推荐使用方式。你只需要将客户端/SDK 的 base_url（或“API 地址”）配置为下列之一即可。

---

1. API 地址列表

1.1 全球智能优化路由（推荐）

• Base URL：https://api.aicy.pro
• 适用场景：海外/跨境网络、希望自动选择更优线路、对稳定性要求更高的场景。

1.2 境内专用地址

• Base URL：https://ai-api.6mq.cn
• 适用场景：中国大陆网络环境访问，追求更低延迟与更稳定连接。

---

2. 选择建议（怎么选用哪个地址）

• 你在中国大陆：优先使用「境内专用地址」
  ​https://ai-api.6mq.cn
• 你在海外或网络环境不确定：优先使用「全球智能优化路由」
  ​https://api.aicy.pro
• 需要高可用：建议做“主备切换”（主地址失败后自动切换到备用地址）。

---

3. 推荐的主备切换策略（可选）

下面是通用思路：先请求主 Base URL，失败（超时/5xx）则自动切换备用 Base URL 重试。

建议配置：

• 连接超时：3–10 秒
• 读取超时：30–120 秒（按你的业务场景调整）
• 重试次数：1–2 次（避免无限重试）

---

4. 在请求中如何使用 Base URL（示例）

说明：不同接口路径取决于你所使用的具体 API 规范。若你使用的是 OpenAI 兼容协议，通常会类似 /v1/...。以下示例仅演示“Base URL 如何拼接使用”。

4.1 cURL 示例（以 OpenAI 兼容写法为例）

将 BASE_URL 替换为上方任意一个地址：

BASE_URL="https://api.aicy.pro"  # 或 https://ai-api.6mq.cn
API_KEY="你的API_KEY"

curl "$BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "你的模型名",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

4.2 Python（如你的 SDK 支持 base_url 配置）

import os

BASE_URL = "https://ai-api.6mq.cn"  # 或 https://api.aicy.pro
API_KEY = os.getenv("AICY_API_KEY")

# 伪代码：不同 SDK 的参数名可能是 base_url / api_base / apiBase 等
client = Client(api_key=API_KEY, base_url=BASE_URL)

resp = client.chat.completions.create(
    model="你的模型名",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp)

---

5. 常见问题排查（FAQ）

5.1 连接超时 / 频繁断开

• 大陆网络优先切换到：https://ai-api.6mq.cn
• 海外网络优先使用：https://api.aicy.pro
• 检查本机 DNS、代理、公司防火墙策略、TLS 拦截等因素

5.2 401 / Unauthorized

• API Key 是否正确、是否过期
• 请求头是否带上：Authorization: Bearer <API_KEY>

5.3 404 / Not Found

• Base URL 正确但“接口路径”不正确（例如是否需要 /v1/...）
• 请以提供的接口文档为准，确认具体 endpoint

‍