跳到主要内容

cURL

cURL 适合快速验证接口地址、API 密钥和模型 ID。对于需要维护的应用，建议使用后续章节中的 Python、Node.js、Anthropic 或 Google GenAI SDK。

检查 cURL​

macOS 和大多数 Linux 发行版通常已经安装 cURL：

curl --version

Windows 10/11 自带 cURL。在 PowerShell 或命令提示符中建议明确使用：

curl.exe --version

使用 curl.exe 可以避免旧版 Windows PowerShell 把 curl 解释为其他命令。

查询模型​

将 YOUR_BITA_API_KEY 替换为完整的 Bita API 密钥。

macOS 与 Linux​

curl "https://www.bita-api.com/v1/models" \
  -H "Authorization: Bearer YOUR_BITA_API_KEY"

Windows 10/11​

curl.exe "https://www.bita-api.com/v1/models" -H "Authorization: Bearer YOUR_BITA_API_KEY"

响应中的 data[].id 是当前密钥可以使用的模型 ID。

准备请求体​

为了避免 Windows 与 Unix 终端的 JSON 引号规则差异，把下面内容保存为当前目录中的 request.json：

request.json
{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "请用一句话介绍 Bita API。"
    }
  ],
  "stream": false
}

发送对话请求​

macOS 与 Linux​

curl "https://www.bita-api.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_BITA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary "@request.json"

Windows 10/11​

curl.exe "https://www.bita-api.com/v1/chat/completions" -H "Authorization: Bearer YOUR_BITA_API_KEY" -H "Content-Type: application/json" --data-binary "@request.json"

模型回复位于：

choices[0].message.content

流式输出​

把 request.json 中的 stream 改为 true，再使用 -N 禁用 cURL 输出缓冲。

macOS 与 Linux​

curl -N "https://www.bita-api.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_BITA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary "@request.json"

Windows 10/11​

curl.exe -N "https://www.bita-api.com/v1/chat/completions" -H "Authorization: Bearer YOUR_BITA_API_KEY" -H "Content-Type: application/json" --data-binary "@request.json"

流式响应会显示多行 data: 事件，并以 [DONE] 结束。应用程序需要解析每个事件的 choices[0].delta.content，详细说明参见流式响应。

查看状态码​

接口返回错误时，可以在命令末尾添加：

-w "\nHTTP %{http_code}\n"

例如：

curl "https://www.bita-api.com/v1/models" -H "Authorization: Bearer YOUR_BITA_API_KEY" -w "\nHTTP %{http_code}\n"

常见问题​

现象建议检查
curl: command not found安装 cURL；Windows 10/11 请尝试 curl.exe
Failed to open request.json当前目录是否存在该文件，文件名是否正确
401Bearer 后是否有空格，密钥是否完整
404请求路径是否重复或遗漏 /v1
model_not_found模型 ID、密钥分组和端点类型是否匹配
流式内容最后一次显示是否设置 "stream": true 并添加 -N

下一步：Python OpenAI SDK。