接入点 — Markdown 源文

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

# 接入点

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

**接入点基址不含 `/v1`。** `/v1` 仅出现在具体 API 路径（如 `/v1/chat/completions`）或 OpenAI SDK 的 `base_url` 配置中。

## 基址一览

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

## 如何选择

- 默认使用 Global。
- 若 Global 不可达或不稳定，改用 CN 备用接入点。
- 切换时只改接入点 host（及 SDK 所需的 `/v1` 拼接），API Key 与其它代码不变。

## OpenAI SDK

OpenAI SDK 的 `base_url` 需在接入点后加 `/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)