Developer API

用一个 API，连接你的应用

NewBee 提供 OpenAI Compatible API。认证、模型查询、Responses、Chat Completions、Embeddings、Images 和 Videos 使用统一入口。

进入 API 控制台
Base URL

https://api.newbeeapi.com/v1

认证：Authorization: Bearer YOUR_API_KEY

认证

所有请求使用 Bearer Token。不要把真实 API Key 写进公开代码、前端页面或日志。

Authorization
Authorization: Bearer YOUR_API_KEY

Models

不要在文档里硬编码当前全部模型。前往 NewBee 模型广场查看模型 ID、能力、价格与上下文；也可以按账号权限请求：

curl
curl https://api.newbeeapi.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Responses API

POST /v1/responses
curl https://api.newbeeapi.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "请回复：NewBee API 连接成功"
  }'

Chat Completions

POST /v1/chat/completions
curl https://api.newbeeapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "你好，NewBee"}
    ]
  }'

Embeddings、Images、Videos 与流式响应

Embeddings、图片和视频模型请以模型广场显示的模型类型与当前服务能力为准。支持流式响应时，在请求中按接口要求设置 stream: true，并在客户端处理事件流。

能力路径选择模型
Embeddings/v1/embeddingsEmbedding 模型
Images/v1/images图片模型
Videos/v1/videos视频模型

错误码

状态码含义优先检查
400请求参数错误JSON、必填字段、模型参数
401认证失败Bearer Key、令牌状态
403无权限模型权限、账号分组
404路径或模型不存在Base URL、endpoint、模型 ID
409请求冲突重复或状态冲突
429限流或额度不足频率、余额、额度
500 / 502 / 503服务或上游异常重试、日志、模型状态
524上游超时请求复杂度、网络和上游状态