快速接入(最常用)
把 Base URL / Key / Model 配好即可。OpenAI / Claude / Gemini 四种最常见接入方式如下。
OpenAI Compatible
Claude Messages
Gemini v1beta
3 分钟接入参数
| 兼容方式 | Base URL | API Key | Model |
|---|---|---|---|
| OpenAI Chat Completions | https://api.xiexus.cn/v1/chat/completions |
平台 Token | 从平台模型清单中选择 |
| Claude 兼容 | https://api.xiexus.cn/v1/messages |
平台 Token | 从平台 Claude 模型清单中选择 |
| Gemini 兼容 | https://api.xiexus.cn/v1beta/models/{model}:generateContent |
平台 Token | 从平台 Gemini 模型清单中选择 |
| OpenAI Responses | https://api.xiexus.cn/v1/responses |
平台 Token | 从平台模型清单中选择 |
提示
大多数 SDK/客户端优先使用 OpenAI 兼容;只有明确需要 Claude 原生 Messages 或 Gemini 原生协议时再切换。
最小请求(Claude Messages)
curl -X POST "https://api.xiexus.cn/v1/messages" \
-H "anthropic-version: 2023-06-01" \
-H "Authorization: Bearer 你的Token" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-3-7-sonnet-20250219",
"messages": [
{ "role": "user", "content": "你好" }
],
"max_tokens": 512
}'
常见报错(简版)
| 现象 | 常见原因 | 优先检查 |
|---|---|---|
401 |
Token 未填写 / Token 错误 / Token 失效或被禁用 | Authorization: Bearer ... |
400 |
请求体字段不符合协议(缺字段、类型不匹配) | model / messages / max_tokens |
404 |
Base URL 配置错误或路径拼接错误 | Claude 接口完整地址为 https://api.xiexus.cn/v1/messages |
模型不可用 |
模型名称错误,或使用了不属于 Claude 协议的模型 | 以平台 Claude 模型清单为准 |
本页面为静态说明页,接口字段以平台实际开放能力为准。