首次调用 API
ZBStream 提供了一个统一的 API,通过单一的端点即可访问数百个 AI 模型。同时能够自动处理回退机制,并选择最具成本效益的解决方案
ZBStream API 模型访问入口,兼容 OpenAI 与 Anthropic SDK。准备好 API Key 后,您可以用熟悉的工具快速发起首次对话请求。
| 参数 | 值 | 说明 |
|---|---|---|
| OpenAI Base URL | https://api.zbstream.com/v1 | 所有 OpenAI 兼容请求的基础地址 |
| Anthropic Base URL | https://api.zbstream.com | Anthropic SDK 基础地址(自动拼接 /v1/messages) |
| API Key | ZBSTREAM_API_KEY | 通过环境变量安全提供访问凭证 |
| 模型 | deepseek-v4-pro | 本示例使用的对话模型 |
根据您想要的控制程度,有以下方式可以与 ZBStream 集成:
| 方法 | 最适合 |
|---|---|
| API | 完全控制,支持任何语言,无任何依赖 |
| OpenAI SDK | 兼容 OpenAI Python / Node.js SDK,接入成本低 |
| Anthropic SDK | 官方 Anthropic Python / Node.js / Go SDK,修改 Base URL 即可 |
| Agent 工具 | 支持可配置自定义 Base URL 的 Agent、IDE 与自动化工具 |
| WorkBuddy & Hermes | 桌面工作台与 Agent 开箱即用,详见接入指南 |
如何获取 ZBStream API Key?
登录 ZBStream Platform,进入 API Keys 页面创建密钥。密钥仅在创建时完整显示,请妥善保管并通过 ZBSTREAM_API_KEY 环境变量使用,不要写入源码或提交到版本库。
如何用 OpenAI 兼容接口调用大模型?
下面四种语言调用同一个 OpenAI 兼容接口。请求均包含消息列表,并关闭流式输出,便于直接查看完整响应。Anthropic 接口用法请参考左侧「Anthropic 接口」文档。
curl https://api.zbstream.com/v1/chat/completions \
-H "Authorization: Bearer $ZBSTREAM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro",
"messages": [
{ "role": "user", "content": "你好,请介绍一下 ZBStream API。" }
],
"stream": false
}'