了解基础 URL
基础 URL 定义客户端发送请求的位置。此处的不匹配会导致立即的连接失败或意外的模型响应。许多开发者假设标准的 OpenAI URL 通用，但无审查提供商通常使用不同的端点将流量路由到特定的模型池。
验证您的配置指向 https://api.openrouterabliteratedmodels.com/v1 用于我们的服务。如果您使用的是第三方聚合器，请确保基础 URL 与他们的文档完全匹配。错误的 URL 通常会导致 404 错误或返回默认模型而非预期的无审查变体。
- 检查您的环境变量中的
BASE_URL或API_HOST. - 确保路径包含
/v1以确保标准兼容性。 - 在大量使用之前，通过简单的模型列表请求测试连通性。
处理速率限制
速率限制规定了您在特定时间窗口内可以发送的请求数量。我们的 API 对每个密钥实施每分钟 300 次请求的限制。超过此阈值将导致 HTTP 429 错误，在窗口重置前暂时阻止进一步请求。
此外，每个密钥的并发请求限制为同时 8 个请求。如果您发送超过 8 个并发请求，超出部分将根据您的客户端库进行排队或失败。监控应用程序的并发性以避免触及这些硬性限制。在代码中使用指数退避策略来优雅地处理 429 错误，而无需向服务器发送垃圾请求。
请记住，每个密钥都是您账户独有的。在多个服务间共享密钥会加速达到这些限制。如果需要为应用的不同部分提供单独的速率限制池，请生成新密钥。
流式与非流式响应
流式随着令牌的生成增量式地返回数据，而非流式则等待完整响应。流式对于实时用户体验至关重要，但需要仔细处理服务器发送事件 (SSE)。
流式传输时，最后一个块包含 token 使用统计信息。如果您提前停止处理，可能会错过此数据。确保您的客户端解析最后一个 SSE 消息，以准确获取输入和输出 token 计数。非流式响应更简单，但对于长输出可能会导致高延迟。
对于用户逐字看到文本出现的聊天界面，请选择流式传输。对于批处理或需要在继续之前获取完整响应的情况，请使用非流式传输。我们的 API 通过 stream 参数在请求体中。
JSON 模式错误
JSON 模式可确保模型输出有效的 JSON，这对于程序化集成至关重要。此处的错误通常源于不正确的标头或模式不匹配。API 要求 response_format: {"type": "json_object"} 用于强制执行严格的 JSON 输出。
如果出现格式错误的 JSON，请检查您的 schema 定义。模型可能会在 JSON 结构之外包含 markdown 代码块或解释性文本。使用能够剥离 markdown 围栏或根据预期 schema 验证输出的健壮解析器。避免使用过于复杂的 schema 以免混淆模型。
先从简单结构开始测试。逐渐增加复杂性，以找出模型的薄弱环节。确保您的温度设置适当，因为较高的温度会增加随机性并降低 JSON 的有效性。
Token 数量计算错误
Token 计数决定您的计费上下文窗口使用情况。计算错误可能导致意外费用或响应被截断。我们的 API 每 1M 输入 Token 收取 $0.15，每 1M 输出 Token 收取 $0.50。
使用与模型分词方案匹配的可靠分词库。不同模型对空白字符或标点的分词方式可能不同，导致本地计数与 API 计数出现差异。始终依赖响应中返回的令牌用量以确保计费准确。
注意你的上下文窗口，总上限为 100,000 个 token。超出此限制将导致错误。请截断较早的消息或摘要以保持在限制范围内。随时间监控 token 使用情况，以优化提示结构并降低成本。
加密货币支付延迟
通过 USDT (TRC20) 或 USDC (Base) 充值可即时到账。不过，网络拥堵有时会导致确认延迟。请确保发送正确的金额和网络，以避免资金损失。
$20 至 $500 的充值为整数金额。奖励信用额度自动应用：$50 起 +5%，$100 起 +10%，$200 起 +15%。验证交易哈希以确认付款。如果信用额度在几分钟后未出现，请检查区块链浏览器以查看交易状态。
余额永不过期，因此无需立即使用。像重复扣款之类的错误可通过支持页面解决。保留您的交易记录，以便在出现问题时轻松参考。
模型 ID 配置
模型 ID 标识您正在使用的无审查模型的版本。对于我们的服务，模型 ID 为 uncensored. 使用错误的 ID 可能导致错误或意外行为。
确保您的请求指定 model: "uncensored" 在请求体中。此 ID 指向我们针对无限制响应调优的特定开放权重模型。它不是通用标识符，而是指向我们托管实例的特定指针。
检查您的客户端库文档，了解如何设置模型 ID。一些库使用 model 字段，而其他字段可能使用不同的参数。在应用程序中保持模型 ID 的一致性可防止混淆，并确保您始终调用预期的 uncensored 模型。
上下文窗口超出
上下文窗口限制了你在单个请求中可以发送的 token 总数。我们的 API 支持 100,000 token 的窗口，包括提示词和补全内容。超出此限制将导致错误。
要管理上下文，请实现滑动窗口策略。删除旧消息或对其进行摘要以释放空间。监控输入 token 的数量，确保其保持在 100,000 token 限制以内。如果您超过限制，API 将拒绝该请求。
使用 max_tokens 用于控制输出长度的参数。每个请求的最大输出为 16,000 个 token。设置此参数有助于防止 token 过度使用，并使响应保持在应用程序可管理的范围内。
支持与退款政策
使用后的余额不予退还，但永不过期。如果遇到支付或服务问题，请通过指定页面联系支持团队。重复扣款等错误由支持团队解决。
对于技术问题，请先查阅文档。我们的 API 简单直接，但可能会出现边缘情况。在寻求帮助时，请提供您的 API 密钥和请求详情。响应时间各不相同，但我们会力求快速解决问题。
请记住，信用额度是预付费的。您为消耗的内容付费，错误和拒绝是免费的。此模式确保账单透明。如有任何差异或关于账户的疑问，请使用支持页面。
