使用错误的 base_url
使用标准的 OpenAI 基础 URL 会导致您的请求失败或路由到完全不同的模型。我们的 API 要求您更改 base_url 到 https://api.whatisopenrouterai.com/v1. 这一行配置确保您的 SDK 连接到我们的服务器，而非全球 OpenAI 基础设施。
许多开发者复制粘贴现有代码而未更新此变量。如果你保留默认 URL，你将要么收到 404 错误，要么命中一个非 uncensored 的模型。始终通过检查 /v1/models 端点。你应该在那里看到我们特定的模型 ID。这确认了路由在发送第一个补全请求之前是正确的。
忘记设置模型 id
即使使用正确的 base URL，省略模型 ID 也会默认为通用或较旧的模型。您必须显式设置 model 参数到 "uncensored" 在每次请求中。这告诉我们的路由层提供针对无限制内容优化的特定开放权重模型。
如果没有此明确指令，您可能会收到具有不同对齐规则的其他模型。某些模型默认会拒绝合法的成人主题。通过强制 uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
忽略代币限制和错误
超过 100,000 token 的上下文窗口或 16,000 token 的输出限制会导致请求立即失败。我们的 API 强制执行每次请求最多 16,000 个 token 的输出。如果您未设置 max_tokens, 默认值仅为 2,048 个 token。这对于复杂推理任务来说通常太短。
错误和拒绝不会消耗您的预付费信用额度。但是，命中速率限制或超过正文大小 (8 MB) 的格式错误的请求仍会占用您的配额。请监控响应头中的令牌使用情况。调整您的提示工程以适配上下文窗口。这防止了昂贵的重试并确保数据流畅。
预付费计费误解
您的账户余额与预付信用额度挂钩，而非月订阅。我们收取每 1M 输入令牌 $0.15 和每 1M 输出令牌 $0.50 的费用。错误免费，但成功的补全会消耗信用额度。您必须通过加密货币充值以维持服务可用性。
我们接受 USDT (TRC20) 或 USDC (Base) 进行充值。最低存款额为 $20。较高档位适用奖金：$50 起赠 5%，$100 起赠 10%，$200 起赠 15%。余额永不过期。在运行大批次任务前请确保余额为正。查看仪表板以验证您的当前余额和最近交易。
将流式传输与标准响应混淆
通过 SSE 流式传输改变了你解析响应流的方式。标准响应返回单个 JSON 对象。流式传输返回多个分块。你必须处理最后一个分块以获得准确的 Token 用量统计。
我们的流式实现包含最后一个块中的 token 用量。如果您提前停止读取流，可能会丢失此数据。请确保您的客户端库正确支持 SSE。这对于在生成时显示 token 的实时应用至关重要。配置不当的流式传输可能导致文本不完整或 UI 状态异常。
tool_choice 配置错误
不正确 tool_choice 设置可能导致函数调用无法按预期工作。您可以强制使用特定工具，或让模型自行决定。配置错误通常导致模型忽略可用功能。
使用 tool_choice 用于控制模型是否自动调用工具。将其设置为 "auto" 用于灵活性，或指定工具 ID 以实现严格行为。确保您的函数定义符合预期模式。这可以避免模型尝试调用不存在函数时出现运行时错误。在部署到生产环境之前，请彻底测试您的工具定义。
缺少 json_object 模式
无 response_format: {"type": "json_object"}, 模型可能会输出 Markdown 或纯文本。这会破坏期望严格 JSON 的解析器。启用 JSON 模式以确保一致且可解析的输出。
此功能对于需要结构化数据的下游系统集成至关重要。它显著减少了后处理开销。始终在客户端代码中验证输出 schema。这有助于抵御偶尔的模型幻觉，确保鲁棒性。在提取实体或生成配置文件时使用此模式。
速率限制意外情况
我们的 API 每个密钥每分钟允许 300 次请求。超出此限制将返回 429 Too Many Errors 响应。每个密钥的并发请求限制为 8 个。请相应地规划您的并发设置。
如果您运行多个进程，请确保它们共享同一个密钥或生成单独的密钥。每个账户仅支持一个活动密钥。新密钥将替换旧密钥。请监控响应中的速率限制头信息。在重试逻辑中实现指数退避。这可以防止高流量期间的级联故障。
加密货币充值延迟
区块链交易确认可能需要时间。发送资金后，您的余额可能不会立即显示。请使用正确的网络：USDT 使用 TRC20，USDC 使用 Base。发送到错误的网络会导致资金损失。
充值金额范围为 $20 至 $500。请确保发送确切金额或考虑网络费用。在区块链浏览器上检查交易哈希值。如果积分延迟到账，请携带交易 ID 联系支持团队。不要立即假设支付失败。在网络拥堵期间保持耐心是顺利操作的关键。
