接入点 — Markdown 源文

> **AI Agents**: 索引 `/api/llms.txt` | 英文全文 `/api/llms-full-en.txt` | 中文全文 `/api/llms-full-zh.txt` | OpenAPI `/api/openapi.yaml`
> Base URL (Global): `https://api.supanexus.ai/v1` | CN: `https://api.supanexus.io/v1`

# 接入点

SupaNexus 提供两个接入点，**共用同一套账号与 API Key**。请求路径、鉴权方式、模型列表与计费完全一致，任选其一即可。

其它文档示例中的 `<BASE_URL>` 请用下表中的基址替换。

## 基址一览

| 站点 | 基址 | 适用场景 |
|------|------|----------|
| Global | `https://api.supanexus.ai/v1` | 默认接入点 |
| CN | `https://api.supanexus.io/v1` | 备用接入点 |

## 如何选择

- 默认使用 Global。
- 若 Global 不可达或不稳定，改用 CN 备用接入点。
- 切换时只改 `base_url` / `SNX_BASE_URL` / `OPENAI_BASE_URL` 等变量，API Key 与其它代码不变。

## OpenAI SDK

OpenAI 兼容路径需带 `/v1`：

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.supanexus.ai/v1",  # 或 "https://api.supanexus.io/v1"
    api_key="your-api-key",
)
```

## Anthropic SDK

Anthropic SDK 的 `base_url` **不含** `/v1`：

```python
import anthropic

client = anthropic.Anthropic(
    api_key="sk-snx-...",
    base_url="https://api.supanexus.ai",  # 或 "https://api.supanexus.io"
)
```

## 相关文档

- [快速开始](./quickstart.md)
- [OpenAI SDK 集成](./openai-sdk-integration.md)
- [Anthropic SDK 集成](./anthropic-sdk-integration.md)