认证

使用控制台创建的 API Key 认证请求。请求头随协议变化，令牌不要放入 URL。

创建与保管令牌

登录 控制台，在「令牌」页添加令牌。检查有效期、额度、模型与 IP 限制是否适合当前调用。将令牌保存在本地环境变量或服务端密钥管理中，不要写入浏览器代码或提交到仓库。

export API_BASE_URL='https://xtemapi.com/v1'
read -r -s -p 'API Key: ' API_KEY; printf '\n'
export API_KEY

read 在 Bash 中交互读取令牌，避免把令牌直接写进命令历史。之后的示例在同一个终端执行。

OpenAI 兼容请求

使用 Authorization: Bearer 请求头。下面调用模型列表，不需要预先指定模型：

curl "$API_BASE_URL/models" \
  -H "Authorization: Bearer $API_KEY"

Anthropic 兼容请求

使用 x-api-key 请求头；Anthropic SDK 的 Base URL 为 https://xtemapi.com，完整请求路径为 /v1/messages。完整示例见 接口约定。Claude Code 的环境变量配置见 Claude Code。

排查认证失败

出现认证错误时，检查令牌是否有效、请求头是否正确，以及客户端是否仍在使用旧令牌。令牌泄露时在控制台删除并重新创建，然后更新客户端配置。具体状态码见 报错码。