# 接口地址 / 端点

> 来源： https://docs.xycai.us/zh/endpoints.html  
> XycAi 开发者文档 · Markdown 版，供 AI / LLM 阅读。全站索引：https://docs.xycai.us/llms.txt

所有端点指向同一套服务、同一个账户与 Key，只是网络线路不同。**国内用户用主端点**，海外或主端点不稳定时切换到其他端点即可，无需改动任何其他配置。

## 一、端点一览

| 端点 | 用途 | 线路 | 建议 |
|---|---|---|---|
| `https://cn.chatapi.app` | 主端点 · 国内直连 | CN2 + 163 + 163 | **国内默认**，文档与客户端示例均使用此地址 |
| `https://jp.chatapi.app` | 全球端点 · 全球 CDN | CN2 + 9929 + CMIN2 | 海外、港澳台与跨境团队优先 |
| `https://apicdn.xycai.us` | 备用端点 | Cloudflare 橙云 | 主端点异常时切换 |
| `https://apicdn.xyc.ai` | 海外直连端点 | 海外直连 | 海外服务器直连；国内访问需代理 |

> **旧地址仍可用**
>
> 早期文档与客户端配置使用的 `https://apicdn.xyc.ai` 继续有效，不需要强制迁移；但 `xyc.ai` 域在国内解析不稳定，国内用户建议改为 `https://cn.chatapi.app`。

## 二、按协议选择 base URL

同一个端点下，不同 SDK / 协议的 base URL 拼法不同。选择端点与协议后直接复制：

| 使用场景 | 填写内容 |
|---|---|
| OpenAI SDK `base_url` / `OPENAI_BASE_URL` | `https://cn.chatapi.app/v1` |
| Anthropic SDK / Claude Code `ANTHROPIC_BASE_URL` | `https://cn.chatapi.app` |
| Codex（Responses API）`base_url` | `https://cn.chatapi.app/v1` |
| Gemini SDK `http_options.base_url` / `GOOGLE_GEMINI_BASE_URL` | `https://cn.chatapi.app` |
| Gemini 原生完整路径 | `https://cn.chatapi.app/v1beta/models/{model}:generateContent` |
| curl / 任意 HTTP 客户端 | `https://cn.chatapi.app/v1/chat/completions` |

## 三、各协议路径速查

| 能力 | 方法 & 路径 | 文档 |
|---|---|---|
| Chat Completions（全厂家通用） | `POST /v1/chat/completions` | [Chat Completions](https://docs.xycai.us/zh/chat.html) |
| Responses API（GPT / Codex） | `POST /v1/responses` | [Responses API](https://docs.xycai.us/zh/responses.html) |
| Claude 原生 | `POST /v1/messages` | [Claude Messages](https://docs.xycai.us/zh/messages.html) |
| Gemini 原生 | `POST /v1beta/models/{model}:generateContent` | [Gemini 原生](https://docs.xycai.us/zh/gemini.html) |
| 图像生成 / 编辑 | `POST /v1/images/generations` · `POST /v1/images/edits` | [图像生成](https://docs.xycai.us/zh/images.html) |
| 视频生成（异步） | `POST /v1/video/generations` → `GET /v1/videos/{task_id}` → `GET /v1/videos/{task_id}/content` | [视频生成](https://docs.xycai.us/zh/video.html) |
| 语音合成 | `POST /v1/audio/speech` | [语音合成](https://docs.xycai.us/zh/speech.html) |
| 向量嵌入 | `POST /v1/embeddings` | [向量嵌入](https://docs.xycai.us/zh/embeddings.html) |
| Jev 判断模型 | `POST /v1/decisions`（兼容 `/v1/systemone`） | [Jev 判断模型](https://docs.xycai.us/zh/jev.html) |
| 模型列表 | `GET /v1/models` | [模型列表](https://docs.xycai.us/zh/models.html) |

## 四、连通性自测

用任意端点执行下面的命令，返回 JSON 模型列表即表示线路与 Key 都正常；可以顺便比较各端点的耗时，选最快的一个：

```
for h in cn.chatapi.app jp.chatapi.app apicdn.xycai.us apicdn.xyc.ai; do
  curl -s -o /dev/null -w "$h  %{http_code}  %{time_total}s\n" \
    -H "Authorization: Bearer sk-xxxxxxxx" https://$h/v1/models
done
```

PowerShell：

```
Invoke-RestMethod -Uri "https://cn.chatapi.app/v1/models" -Headers @{ Authorization = "Bearer sk-xxxxxxxx" }
```

## 五、注意事项

- **长请求请使用流式**（`stream: true`）。非流式长任务（超过数分钟无字节返回）可能被中间网络设备的空闲超时掐断。
- **WebSocket**：Codex 的 `wss://…/v1/responses` 已在全部端点支持。
- 支付回调、控制台与 API 端点是不同域名；控制台在 [www.xycai.us](https://www.xycai.us)（国内站 [www.xycai.cn](https://www.xycai.cn)）。