1. 无忧引擎 API
无忧引擎 API
  • 无忧引擎 API
    • 引言
    • 发出请求
    • 在线调试说明
    • 模型
      • 获取可用模型列表
      • 获取指定模型信息
    • OpenAI 兼容接口(Chat Completions)
      • 创建聊天对话
    • OpenAI 兼容接口(Responses API)
      • 创建模型响应
      • 压缩 Responses 对话上下文
    • Claude 原生接口(Messages)
      • 创建 Claude Messages 对话
    • Gemini 原生接口
      • 创建 Gemini 原生响应
      • 创建 Gemini 原生流式响应
    • 帮助中心
      • HTTP 状态码及其含义
  1. 无忧引擎 API

在线调试说明

Apifox 可以直接向无忧引擎生产环境发送测试请求。调试请求会产生真实调用和费用。

第一次调试#

1.
在接口页面右上角选择“调试”或“运行”。
2.
确认环境地址为 https://hub.wuyoufanyi.com。
3.
在 Auth 中选择 Bearer Token。
4.
Token 只填写 API Key 本身,不要重复填写 Bearer 。
5.
修改请求体中的 model 和输入内容。
6.
点击“发送”。

推荐环境变量#

建议在 Apifox 环境中创建以下变量:
变量示例值是否敏感
baseUrlhttps://hub.wuyoufanyi.com否
apiKeysk-xxxxxxxx是
接口地址使用:
{{baseUrl}}/v1/chat/completions
Bearer Token 使用:
{{apiKey}}
应将 apiKey 标记为敏感数据,避免在导出项目或分享截图时泄露。

Claude Messages 调试#

调用 POST /v1/messages 时可使用以下请求头:
也可以使用统一的 Bearer Token 鉴权。

Gemini 原生接口调试#

Gemini 原生接口可以使用:
也可以使用统一的 Bearer Token 鉴权。流式接口建议在 URL 后添加:
?alt=sse

常见问题#

返回 401#

检查 API Key 是否完整、是否被删除,以及 Auth 中是否重复填写了 Bearer 。

返回 403#

当前 API Key、用户分组或渠道可能没有该模型权限。请检查模型授权和令牌模型限制。

返回 404#

检查请求地址、接口路径和模型名称。模型名称应与模型广场或 GET /v1/models 返回值完全一致。

返回 429#

可能是请求频率过高、并发限制、额度不足或上游限流。请结合响应内容和控制台使用日志判断。

请求长时间没有返回#

确认是否启用了流式响应。翻译业务应设置合理的连接与请求超时,并对可重试错误进行有限次数重试,避免无限等待。
上一页
发出请求
下一页
获取可用模型列表
Built with