主题
API 端点说明
统一端点,稳定接入
概述
AbuAI 提供统一的官方 API 端点(OpenAI 兼容)。你只需要配置一个 base_url 即可开始调用。
官方端点(推荐)
| 配置项 | 值 |
|---|---|
| 地址 | https://api.abuai.chat |
| API Base | https://api.abuai.chat/v1 |
| 说明 | 功能完整,稳定可用 |
使用示例
使用官方端点
python
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxxxxxxxxxxxx",
base_url="https://api.abuai.chat/v1"
)cURL 示例
bash
# 使用官方端点
curl https://api.abuai.chat/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'环境变量配置
bash
# 官方端点
export OPENAI_API_BASE="https://api.abuai.chat/v1"端点选择建议
| 场景 | 推荐端点 | 原因 |
|---|---|---|
| 日常开发测试 | api.abuai.chat | 功能完整 |
| 生产环境 | api.abuai.chat | 稳定可用 |
| 需要控制台 | api.abuai.chat | 同域名访问 |
故障转移
如果你有自建/备份节点(可选),建议在代码中实现端点故障转移:
python
from openai import OpenAI
ENDPOINTS = [
"https://api.abuai.chat/v1", # 官方端点
"https://your-backup.example/v1", # 自建/备份节点(可选)
]
def create_client():
for base_url in ENDPOINTS:
try:
client = OpenAI(
api_key="sk-xxxxxxxxxxxxxxxx",
base_url=base_url,
timeout=10
)
# 测试连接
client.models.list()
return client
except Exception:
continue
raise Exception("All endpoints unavailable")
client = create_client()常见问题
Q: 数据是同步的吗?
A: 如果你使用的是同一套后端(例如官方服务或你自建的同源后端),数据天然一致;不同部署之间的数据是否同步取决于你的部署方式与数据库配置。
下一步
配置一个地址,即可开始使用