接口总览
约 805 字大约 3 分钟
2025-02-10
API 参考文档
对于用户侧,系统采用二级鉴权机制:公开、用户
接口前缀统一为 https://api.ai.webweb.cn
注意
生产环境应使用 HTTPS 以保证认证令牌安全。HTTP 仅建议用于开发环境。
接口类型
New API 提供两大类接口:
- 中继接口 - 用于 AI 模型的调用,支持多种主流模型格式
- 前端接口 - 用于支持 Web 界面的功能调用,提供完整的前端功能支持
🗨️ 中继接口
聊天(Chat)
支持多种主流聊天模型格式:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| OpenAI Chat | 标准 OpenAI 聊天接口 | 查看文档 |
| OpenAI Responses | OpenAI 响应式接口 | 查看文档 |
| Anthropic Chat | Claude 模型聊天接口 | 查看文档 |
| Deepseek Chat | Deepseek 模型接口 | 查看文档 |
| Google Chat | Gemini 模型接口 | 查看文档 |
嵌入(Embeddings)
文本向量嵌入服务:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| OpenAI Embeddings | 文本向量化接口 | 查看文档 |
重排序(Rerank)
搜索结果重排序服务:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| Jina AI Rerank | Jina 重排序服务 | 查看文档 |
| Cohere Rerank | Cohere 重排序服务 | 查看文档 |
| Xinference Rerank | Xinference 重排序服务 | 查看文档 |
实时对话(Realtime)
支持流式实时对话:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| OpenAI Realtime | WebSocket 实时对话 | 查看文档 |
图像(Image)
AI 图像生成服务:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| OpenAI Image | DALL·E 图像生成 | 查看文档 |
| Midjourney Proxy | Midjourney 代理服务 | 查看文档 |
音频(Audio)
AI 语音服务:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| OpenAI Audio | TTS/STT 语音服务 | 查看文档 |
音乐(Music)
AI 音乐生成服务:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| Suno API | AI 音乐生成 | 查看文档 |
视频(Video)
AI 视频生成和查询服务:
| 接口 | 说明 | 文档链接 |
|---|---|---|
| 生成视频 | AI 视频生成 | 查看文档 |
| 查询视频 | 视频状态查询 | 查看文档 |
🖥️ 前端接口
鉴权相关
| 接口 | 说明 |
|---|---|
| 鉴权体系说明 | 了解 API 鉴权机制 |
| 获取可用模型列表 | 查询当前可用的模型 |
通用请求格式
请求头
所有 API 请求需要包含以下请求头:
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json响应格式
API 响应统一使用 JSON 格式:
{
"id": "chatcmpl-xxx",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-3.5-turbo",
"choices": [...],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 20,
"total_tokens": 30
}
}错误响应
当请求出错时,API 会返回错误信息:
{
"error": {
"message": "错误描述",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}常见错误码
| 状态码 | 说明 |
|---|---|
| 400 | 请求参数错误 |
| 401 | API 密钥无效或缺失 |
| 403 | 权限不足 |
| 404 | 资源不存在 |
| 429 | 请求过于频繁,请稍后重试 |
| 500 | 服务器内部错误 |
速率限制
为保障服务稳定,我们对 API 调用实施速率限制:
| 等级 | RPM (每分钟请求数) | TPM (每分钟Token数) |
|---|---|---|
| 免费用户 | 60 | 40,000 |
| 付费用户 | 500 | 200,000 |
| 企业用户 | 3000 | 1,000,000 |
提示
如需更高的速率限制,请联系我们的销售团队。
