API 调用示例

下面示例使用 OpenAI-compatible 的请求方式。实际 Base URL 和模型名以你的 Arqel 控制台为准。你可以把它当作 API 调试的基准样例。

TIP

如果你是新手，只想接入 Cursor、Claude Code、Codex 或 CC Switch，请先看新手入门。这页属于 API 参考，不是 Agent 入门的必经步骤。

WARNING

模型名请使用 Arqel 控制台中显示的具体名称。不要把其他平台里的模型别名或示例占位文字直接填入请求。

这一页的目标是给后端、脚本、SDK 和深度排障用户一个最小、可复用的调用样例，便于理解请求结构。

开始前准备

你需要提前准备：

一个 Arqel API Key，例如 sk-...。
Arqel Base URL，例如 https://arqel.net。
一个控制台里显示可用的具体模型名。
一个终端：macOS 终端、Windows PowerShell、Linux / WSL 终端都可以。

请把 Base URL 和模型名从 Arqel 控制台复制出来，不要凭经验手写。模型名必须是控制台显示的具体名称。

如果你还没有这些，请先阅读：

1. 设置环境变量

环境变量可以避免你把 Key 直接写在命令里。

macOS / Linux / WSL：

bash

export ARQEL_API_KEY="sk-..."
export ARQEL_BASE_URL="https://arqel.net"
export ARQEL_MODEL="请替换为控制台里可用的模型名"

Windows PowerShell：

powershell

$env:ARQEL_API_KEY="sk-..."
$env:ARQEL_BASE_URL="https://arqel.net"
$env:ARQEL_MODEL="请替换为控制台里可用的模型名"

TIP

这里的 sk-... 和模型名都要替换成你自己的实际内容。不要连引号里的示例文字一起原样复制。

2. 确认 cURL 可用

cURL 是一个在终端里发送网络请求的工具。

macOS 和大多数 Linux 通常自带 cURL。Windows 10/11 通常也已经内置。

验证：

macOS / Linux / WSL：

bash

curl --version

Windows PowerShell：

powershell

curl.exe --version

如果能看到版本号，就可以继续。

如果 Windows PowerShell 行为异常，可以先跳过 cURL，后续使用 OpenAI SDK 或工具内置测试。

cURL 示例

macOS / Linux / WSL：

bash

curl "$ARQEL_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $ARQEL_API_KEY" \
  -H "Content-Type: application/json" \
  -w "\nHTTP %{http_code}\n" \
  -d '{
    "model": "'"$ARQEL_MODEL"'",
    "messages": [
      { "role": "user", "content": "你好，介绍一下 Arqel" }
    ]
  }'

Windows PowerShell 使用 curl.exe，不要只写 curl。在 PowerShell 里，curl 可能是 Invoke-WebRequest 的别名，行为和真正的 cURL 不完全一样。

powershell

$body = @{
  model = $env:ARQEL_MODEL
  messages = @(
    @{
      role = "user"
      content = "你好，介绍一下 Arqel"
    }
  )
} | ConvertTo-Json -Depth 5

curl.exe "$env:ARQEL_BASE_URL/chat/completions" `
  -H "Authorization: Bearer $env:ARQEL_API_KEY" `
  -H "Content-Type: application/json" `
  -w "`nHTTP %{http_code}`n" `
  -d $body

PowerShell 多行命令末尾的反引号 ` 表示“下一行还是同一条命令”。反引号后面不要加空格，否则可能失效。

如果你不想处理 cURL，也可以使用 PowerShell 原生的 Invoke-RestMethod：

powershell

$body = @{
  model = $env:ARQEL_MODEL
  messages = @(
    @{
      role = "user"
      content = "你好，介绍一下 Arqel"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "$env:ARQEL_BASE_URL/chat/completions" `
  -Method Post `
  -Headers @{
    Authorization = "Bearer $env:ARQEL_API_KEY"
    "Content-Type" = "application/json"
  } `
  -Body $body

这段请求每一部分是什么意思

text

POST /chat/completions

表示你要发送一个聊天补全请求。

text

Authorization: Bearer <你的 API Key>

表示用你的 Key 证明“我是有权限调用的人”。

json

{
  "model": "模型名",
  "messages": [
    { "role": "user", "content": "你好，介绍一下 Arqel" }
  ]
}

表示你指定一个模型，并发送一条用户消息。

成功后应该看到什么

终端最后一行显示 HTTP 200。
返回内容里有模型回复。
控制台中可以看到这次调用的消耗或记录。

返回内容通常是一大段 JSON。新手不需要全部看懂，先找这几个信号：

没有出现 401、403、429、500 等错误码。
返回里有 choices 或类似字段。
message.content 或类似字段里有文字回复。

怎么确认真的走了 Arqel

终端有回复还不够。建议回到 Arqel 控制台，查看用量或请求记录。如果控制台提供这些字段，请核对：

请求时间是否和刚才测试一致。
Key 名称是否是你刚创建或专门用于测试的 Key。
模型名是否和 ARQEL_MODEL 一致。
状态码或结果是否显示成功。

如果失败

优先检查：

API Key 是否复制完整。
Base URL 是否填写正确。
Authorization 头是否是 Bearer sk-...。
模型名是否可用。
账户余额或额度是否足够。
Windows PowerShell 是否使用了 curl.exe，而不是 curl 别名。

更多排查见成功和失败示例和请求失败排查。

下一步

继续阅读：

API 调用示例 ​

开始前准备 ​

1. 设置环境变量 ​

2. 确认 cURL 可用 ​

cURL 示例 ​

这段请求每一部分是什么意思 ​

成功后应该看到什么 ​

怎么确认真的走了 Arqel ​

如果失败 ​

下一步 ​

API 调用示例

开始前准备

1. 设置环境变量

2. 确认 cURL 可用

cURL 示例

这段请求每一部分是什么意思

成功后应该看到什么

怎么确认真的走了 Arqel

如果失败

下一步