接口地址 / 端点

所有端点指向同一套服务、同一个账户与 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
Responses API（GPT / Codex）	`POST /v1/responses`	Responses API
Claude 原生	`POST /v1/messages`	Claude Messages
Gemini 原生	`POST /v1beta/models/{model}:generateContent`	Gemini 原生
图像生成 / 编辑	`POST /v1/images/generations` · `POST /v1/images/edits`	图像生成
视频生成（异步）	`POST /v1/video/generations` → `GET /v1/videos/{task_id}` → `GET /v1/videos/{task_id}/content`	视频生成
语音合成	`POST /v1/audio/speech`	语音合成
向量嵌入	`POST /v1/embeddings`	向量嵌入
Jev 判断模型	`POST /v1/decisions`（兼容 `/v1/systemone`）	Jev 判断模型
模型列表	`GET /v1/models`	模型列表

四、连通性自测

用任意端点执行下面的命令，返回 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（国内站 www.xycai.cn）。