一分钟接入

API Key、模型 ID 和一条请求就能确认基础调用是否接通。不需要安装客户端，也不依赖其他页面的命令。

快速接入视频

手边需要的内容

内容	获取位置
API Key	Xikapi 控制台
模型 ID	Xikapi 控制台中当前账号可用的模型

将下面命令中的 YOUR_XIKAPI_API_KEY 和 YOUR_MODEL_ID 换成控制台里的值。模型可用性由当前账号和权限决定。

Windows PowerShell

$apiKey = "YOUR_XIKAPI_API_KEY"
$model = "YOUR_MODEL_ID"
$body = @{
  model = $model
  messages = @(@{ role = "user"; content = "Reply with OK only." })
} | ConvertTo-Json -Depth 4

Invoke-RestMethod `
  -Uri "https://xikapi.com/v1/chat/completions" `
  -Method Post `
  -ContentType "application/json" `
  -Headers @{ Authorization = "Bearer $apiKey" } `
  -Body $body

macOS 或 Linux

export XIKAPI_API_KEY="YOUR_XIKAPI_API_KEY"
export XIKAPI_MODEL="YOUR_MODEL_ID"

curl https://xikapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XIKAPI_API_KEY" \
  -d "{\"model\":\"$XIKAPI_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with OK only.\"}]}"

接通后看到什么

终端会返回 JSON，其中通常包含模型生成的文本。这个结果说明 Key、模型 ID 和基础文本请求已经连通；图片、联网、函数调用等能力仍以模型和账号权限为准。

报错

现象	对应检查
401 或 Invalid API Key	Key 是否完整复制，是否来自 Xikapi 控制台
403 或 model not found	模型 ID 的大小写与后缀，以及该 Key 的模型权限
404	直接 HTTP 请求使用完整地址 https://xikapi.com/v1/chat/completions
400	请求是否混入其他协议字段或未确认的高级参数
429、超时或 5xx	控制台中的额度、速率和服务状态，以及客户端超时设置

SDK 或聊天客户端填写的是 Base URL https://xikapi.com/v1，不含 /chat/completions；直接 HTTP 请求才使用上面的完整地址。完整的环境变量、JavaScript、Python 和错误参考在 快速开始。

接入完成后可进入 聊天客户端、代码助手、知识库与工作流 或 团队网关。