OpenAI 兼容 API

WebberAI 的 OpenAI 兼容入口适合绝大多数 SDK、Agent、ChatBot 和 IDE 插件。

API 端点

Base URL: https://webberai.top/v1
Models: /models
Chat Completions: /chat/completions
Responses: /responses

完整请求地址示例：

https://webberai.top/v1/chat/completions

认证方式

Authorization: Bearer YOUR_WEBBERAI_API_KEY

获取模型列表

curl https://webberai.top/v1/models \
  -H "Authorization: Bearer YOUR_WEBBERAI_API_KEY"

Chat Completions

curl https://webberai.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_WEBBERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从模型广场复制的模型 ID",
    "messages": [
      { "role": "user", "content": "请用一句话介绍 WebberAI。" }
    ]
  }'

流式响应

curl https://webberai.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_WEBBERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从模型广场复制的模型 ID",
    "stream": true,
    "messages": [
      { "role": "user", "content": "输出三条使用建议。" }
    ]
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_WEBBERAI_API_KEY",
    base_url="https://webberai.top/v1",
)

response = client.chat.completions.create(
    model="从模型广场复制的模型 ID",
    messages=[
        {"role": "user", "content": "你好，WebberAI。"}
    ],
)

print(response.choices[0].message.content)

Responses API

如果你的客户端使用 Responses API，保持同一 Base URL：

curl https://webberai.top/v1/responses \
  -H "Authorization: Bearer YOUR_WEBBERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "从模型广场复制的模型 ID",
    "input": "写一个简短的产品说明。"
  }'

Images API

图像生成或多模态接口是否可用，取决于模型广场中的模型能力。使用前先确认模型支持图像能力。

错误处理

错误	常见原因	处理方式
401 / INVALID_API_KEY	API Key 错误、过期或复制不完整	重新创建并复制 API Key
404	Base URL 错误或重复 /v1	检查是否写成 /v1/v1
模型不存在	模型 ID 错误或已下架	从模型广场重新复制
余额不足	账号余额不可用	查看 Dashboard / Purchase / Redeem