跳到正文

开始使用

快速开始

创建令牌,三步完成第一次调用。

示例中的 YOUR_MODEL 请替换为 模型广场 中可用且支持所需协议的模型名。

三步完成第一次调用。

1. 创建令牌

登录 控制台,进入「令牌」页,点击「添加令牌」,复制生成的 sk- 开头的 API Key。

保管好令牌

令牌等同于账户余额的使用权。不要提交到代码仓库,也不要发给任何人,包括自称客服的人。

2. 选择接入地址

协议Base URL适用客户端
OpenAI 兼容https://xtemapi.com/v1OpenAI SDK、Cherry Studio、大多数第三方客户端
Anthropichttps://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 即接入成功。模型名可在 模型广场 复制。

下一步

进一步阅读 认证、接口约定 与 流式输出。