开始使用
快速开始
创建令牌,三步完成第一次调用。
示例中的 YOUR_MODEL 请替换为 模型广场 中可用且支持所需协议的模型名。
三步完成第一次调用。
1. 创建令牌
登录 控制台,进入「令牌」页,点击「添加令牌」,复制生成的 sk- 开头的 API Key。
保管好令牌
令牌等同于账户余额的使用权。不要提交到代码仓库,也不要发给任何人,包括自称客服的人。
2. 选择接入地址
| 协议 | Base URL | 适用客户端 |
|---|---|---|
| OpenAI 兼容 | https://xtemapi.com/v1 | OpenAI SDK、Cherry Studio、大多数第三方客户端 |
| Anthropic | https://xtemapi.com(不带 /v1) | Claude Code、Anthropic SDK、CC Switch |
客户端会自己在 Base URL 后拼接路径,例如 /chat/completions 或 /v1/messages,所以 Anthropic 地址不要带 /v1,否则会变成 /v1/v1/messages 并返回 404。
3. 发起请求
在 Bash 中复制整段,按提示输入令牌与模型名。需要 curl 和 Python 3;输入会自动编码为 JSON:
Bash
export API_BASE_URL='https://xtemapi.com/v1'
read -r -s -p 'API Key: ' API_KEY; printf '\n'
read -r -p 'Model: ' MODEL
export API_KEY MODEL
curl "$API_BASE_URL/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
--data "$(python3 -c 'import json,os; print(json.dumps({"model":os.environ["MODEL"],"messages":[{"role":"user","content":"Hello"}]}))')"返回 JSON 中有 choices[0].message.content 即接入成功。模型名可在 模型广场 复制。
下一步
- 接入具体客户端:Claude Code、Cherry Studio、CC Switch
- 在代码里调用:OpenAI SDK、Anthropic SDK
- 遇到报错:报错码