ZBStream

首次调用 API

ZBStream 提供了一个统一的 API，通过单一的端点即可访问数百个 AI 模型。同时能够自动处理回退机制，并选择最具成本效益的解决方案

ZBStream API 模型访问入口，兼容 OpenAI SDK。准备好 API Key 后，您可以用熟悉的工具快速发起首次对话请求。

参数值说明
Base URLhttps://api.bewarezone.com所有 OpenAI 兼容请求的基础地址
API KeyBEWARE_API_KEY通过环境变量安全提供访问凭证
模型deepseek-v4-pro本示例使用的对话模型

根据您想要的控制程度，有四种方式可以与 ZBStream 集成：

方法最适合
API完全控制，支持任何语言，无任何依赖
OpenAI SDK兼容 OpenAI Python / Node.js SDK，接入成本低
Agent 工具支持可配置自定义 Base URL 的 Agent、IDE 与自动化工具
BewareClaw开箱即用的桌面 Agent，支持工具调用、会话状态与文件工作流

如何获取 ZBStream API Key？

登录 ZBStream Platform，进入 API Keys 页面创建密钥。密钥仅在创建时完整显示，请妥善保管并通过 ZBStream_API_KEY 环境变量使用，不要写入源码或提交到版本库。

前往创建 API Key

如何用 OpenAI 兼容接口调用大模型？

下面三种方式调用同一个 OpenAI 兼容接口。请求均包含消息列表，并关闭流式输出，便于直接查看完整响应。

curl https://api.bewarezone.com/v1/chat/completions \
  -H "Authorization: Bearer $BEWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      { "role": "user", "content": "你好，请介绍一下 ZBStream API。" }
    ],
    "stream": false
  }'