API 基础地址（Base URL）

💡 介绍

本文档用于说明爱次元 API 的基础访问地址（Base URL）以及不同线路的适用场景。你只需要将客户端、SDK 或开发工具中的 base_url（或“API 地址”）配置为下列任意一条即可。

🌍 线路选择说明

根据网络环境选择合适的 API 地址
如无特殊需求，优先使用推荐线路

当前文档只保留三条可用线路：全球智能优化路由、香港线路、新加坡线路。默认建议优先使用全球智能优化路由，如业务对区域节点有明确要求，再按需切换到香港或新加坡线路。

推荐线路香港线路新加坡线路可直接配置

📍 可用地址列表

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

https://api.aicy.pro

适用于海外 / 跨境网络、希望自动选择更优线路、以及对稳定性要求更高的场景。

🇭🇰 香港线路

https://a.aicy.pro

适用于对香港节点有明确要求，或需要按区域线路进行测试与接入的场景。

🇸🇬 新加坡线路

https://b.aicy.pro

适用于对新加坡节点有明确要求，或希望按区域线路进行选择的场景。

✅ 选择建议

默认优先使用推荐线路

如无特殊需求，建议优先使用 全球智能优化路由：https://api.aicy.pro

如果你的业务对节点区域有明确要求，或者当前线路访问异常，再按需切换到 香港线路 或 新加坡线路。

🔄 切换建议

🌐 默认场景

直接使用全球智能优化路由，通常已经可以覆盖大多数日常调用场景。

📌 区域偏好场景

如果你明确需要香港或新加坡节点，可直接将对应线路配置为当前 Base URL。

⚠️ 当前线路异常

若当前线路出现超时、连接异常或访问不稳定，可切换到其他线路继续测试和使用。

🧩 与主备地址配合

如果你还需要了解主备切换思路，可以结合“主备地址”文档一起查看。

🧪 请求示例

💡 提示

下方示例默认使用推荐线路。若你需要切换到香港或新加坡线路，只需替换 BASE_URL 即可。

cURL 示例

bash

BASE_URL="https://api.aicy.pro"
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": "你好，介绍一下你自己"}
    ]
  }'

Python 示例

python

import os

BASE_URL = "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)

❓ 常见问题

如何选择线路？

默认优先使用全球智能优化路由。香港和新加坡线路适合有明确区域节点需求的场景。

请求超时或连接异常怎么办？

先确认当前 `base_url` 是否填写正确，再尝试切换到其他可用线路，并检查本机网络、代理或防火墙环境。

401 / Unauthorized

请检查 API Key 是否正确、是否过期，并确认请求头中已带上 Authorization: Bearer <API_KEY>。

404 / Not Found

这通常表示 Base URL 正确，但接口路径不正确。具体请求路径请以你所使用的接口规范或客户端要求为准。

API 基础地址（Base URL） ​

根据网络环境选择合适的 API 地址如无特殊需求，优先使用推荐线路

📍 可用地址列表 ​