RequestBeam

文档目录

RequestBeam 文档

连接与使用问题

连接失败、模型无响应、请求报错或对话中断时的常见排查方法。

遇到连接失败、模型无响应或对话中断时，先用最小请求确认三件事：鉴权是否通过、入口路径是否正确、模型是否可用。

无法连接到平台服务？

请优先检查：

  • API Key 是否正确配置，是否多复制了空格或换行。
  • Base URL 是否填写正确，且没有重复路径或错误前缀。
  • 当前接口路径是否与客户端协议一致，例如 OpenAI 兼容客户端应使用对应兼容入口。
  • 本地网络、公司代理、防火墙、DNS 或 HTTPS 检查是否拦截请求。
  • API Key 是否已过期、被删除，或所属账户状态受限。

如果使用 OpenAI 兼容接口，可以先用最小非流式对话请求验证连通性：

bash
curl https://api.requestbeam.com/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ]
  }'

如果最小请求也无法返回，问题通常还在网络、鉴权、路径配置、模型权限或账户状态层。

模型选择后没有响应或报错？

常见原因包括：

  • 模型 ID 不准确，和平台实际返回的模型列表不一致。
  • 选择的模型暂时不可用，或当前 API Key 没有访问权限。
  • 请求格式不符合对应接口要求，例如字段名、嵌套结构或数据类型错误。
  • 账户余额不足，或请求超出上下文长度、输出长度、服务超时等限制。
  • 第三方客户端没有正确处理流式响应或错误响应。

建议先从控制台或模型列表接口复制准确的模型 ID，再用最小请求体测试。确认最小请求可用后，再逐步加回上下文和其他参数。

对话出现错误或中断怎么办？

先区分中断发生在什么阶段：

  • 请求开始前失败：重点检查鉴权、路径、模型和请求参数。
  • 流式返回中途断开：重点检查客户端超时、代理链路和 SSE 解析。
  • 长上下文或长输出时失败：重点检查请求体大小、输出长度和服务超时。

处理建议：

  1. 阅读错误消息中的具体字段，确认是否为参数、余额、权限或服务限制问题。
  2. 临时改为非流式请求，判断是模型调用异常还是流式解析异常。
  3. 对 429、网络波动和部分 5xx 错误增加退避重试。
  4. 重试时显式带上必要上下文，不要假设服务端自动保存会话。
  5. 如果问题持续，请记录 X-Request-ID 后联系支持。