Skip to main content
本页用于验证 XRouter API Key、服务地址和模型名是否可用。工具接入前建议先跑通一次请求。

​
前置条件

  • 已注册并登录 XRouter 控制台。
  • 已创建一把 API Key，格式通常为 sk-...。
  • 账户有可用额度，目标模型已在控制台中可见。

​
配置环境变量

Terminal
export XROUTER_BASE_URL="https://api.xrouter.dev"
export XROUTER_API_KEY="sk-your-api-key"
复制命令时把 sk-your-api-key 替换成控制台生成的真实 API Key。不要把真实密钥提交到代码仓库。

​
验证 API Key

先请求模型列表，确认密钥和地址可用。
Terminal
curl "$XROUTER_BASE_URL/v1/models" \
  -H "Authorization: Bearer $XROUTER_API_KEY"
如果返回模型列表，说明 API Key 可以被 XRouter 识别。接着发起一次 OpenAI Chat Completions 请求。 
curl "$XROUTER_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $XROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [
      {
        "role": "user",
        "content": "用一句话介绍 XRouter。"
      }
    ]
  }'
请求成功后，你可以继续配置 Claude Code、Codex CLI 或 CC Switch。模型名建议从控制台模型页复制，避免拼写差异。

​
常见问题

检查 API Key 是否包含完整 sk- 前缀，确认请求头格式是 Authorization: Bearer sk-...。如果你复制的是隐藏后的密钥，请重新在控制台查看或新建密钥。
先调用 /v1/models 查看当前密钥可用模型，再把工具中的模型名改成列表中存在的值。不同分组、额度或渠道可能影响可见模型。
先用本页的 cURL 验证网络和密钥。如果 cURL 成功，再检查工具是否把 base URL 写成了 https://api.xrouter.dev/v1 或 https://api.xrouter.dev 对应的正确形式。