Wagbrio API 接入教程

Wagbrio 提供 OpenAI 兼容的 AI API 网关能力。开发者可以使用统一的 /v1 API 地址、API Key 和模型参数，把应用接入到 Wagbrio 支持的模型通道。

API Base URL：https://www.wagbrio.com/v1
鉴权方式：在请求头中使用 Authorization: Bearer YOUR_API_KEY。

接入步骤

1. 注册并进入控制台

先在 Wagbrio 创建账号，进入控制台后可以查看模型、额度、价格和用量记录。

2. 创建 API Key

为应用、客户或团队创建独立 API Key。独立密钥方便后续统计用量、排查问题和控制额度。

3. 配置 API 地址

在支持 OpenAI 兼容格式的客户端中，将 API Base URL 设置为 https://www.wagbrio.com/v1。

4. 发送测试请求

使用真实模型名和 API Key 发送请求，然后在 Wagbrio 控制台查看用量日志和扣费记录。

curl 示例

curl https://www.wagbrio.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_NAME",
    "messages": [
      {"role": "user", "content": "请用一句话介绍 Wagbrio"}
    ]
  }'

常见问题

Wagbrio 和 OpenAI API 完全一样吗？

Wagbrio 使用 OpenAI 兼容的调用格式，但具体支持的模型、计费、通道和返回能力取决于平台配置。

为什么请求会返回 401？

常见原因是 API Key 错误、密钥未启用、额度不足、请求头缺少 Authorization，或客户端使用了错误的 API Base URL。

如何排查延迟？

可以分别检查客户端到 Wagbrio、Wagbrio 到上游通道、模型处理时间和返回传输时间。Wagbrio 的用量日志和上游通道路由能帮助定位慢在哪一段。