The OpenRouter API 已解释

什么是 OpenAI 兼容 API？

这是一个遵循 OpenAI chat-completions 接口的 REST API。您发送提示词并接收文本输出，使用标准的 JSON 负载。这种兼容性意味着您的现有客户端代码无需重大更改即可工作。

主要端点为 POST /v1/chat/completions。它接受由角色和内容对象组成的消息数组。你还可以通过 GET /v1/models 列出可用模型。这种标准化显著减少了集成时间。

我们的服务完全符合此接口。我们以 "uncensored" 为 ID 提供单一无审查模型。它运行在我们自己的服务器上。它不路由到其他厂商。您将获得所需模型的直接访问权限。

上下文窗口总共支持多达 100,000 个 token。输出限制为每次请求 16,000 个 token。通过服务器发送事件提供流式传输。完全支持功能调用和 JSON 模式。

理解基础 URL 和 API 密钥

基础 URL 指向处理您请求的服务器。您将默认的 OpenAI URL 替换为我们的特定端点。我们的基础 URL 是 HTTPS://api.openrouterabliterated.com/v1。此更改将流量引导至我们的 uncensored 基础设施。

API 密钥验证您的请求。您为每个账户生成一个密钥。注册后立即显示该密钥。如果需要，您可以替换它。每个账户同时只持有一个活跃密钥。

速率限制按密钥强制执行。您可以每分钟发送 300 次请求。最多 8 个请求可以同时运行。请求体限制为 8 MB。这些限制很好地处理了高容量使用情况。

注册仅需邮箱或 Google 账号。无需电话号码。密钥立即出现。您可以立即开始发送请求。隐私得到保护；提示词不用于训练。

为什么为你的用例选择无审查模型？

无审查模型不会拒绝合法的成人、虚构或争议性话题。它们非常适合创意写作、角色扮演或研究。主流模型通常会应用严格的护栏。这些护栏可能会中断生成的流程。

我们的模型直接回答。它处理 NSFW 内容时没有阻力。它非常适合政治哲学或利基流派。你获得一致的行为，无需额外提示。

支持工具使用。您可以为应用定义工具。模型尊重工具选择。这使其适合复杂的工作流。错误和拒绝不收费。您只为实际使用付费。

内容限制仍然适用。涉及未成年人的性内容始终被拒绝。这是一个硬性限制。它确保基本的安全标准。其他所有内容都是你的用例的公平游戏。

Token 定价：成本计算方式

定价基于令牌用量。输入令牌每 100 万个令牌 0.15 美元。输出令牌每 100 万个令牌 0.50 美元。您只为所用内容付费。无隐藏费用。

余额为预付制。您仅使用加密货币充值。接受 TRC20 上的 USDT 或 Base 上的 USDC。允许 $20 至 $500 之间的任何整额。余额永不过期。这避免了订阅锁定。

充值可获得额外额度。充值 $50 获得 +5%。充值 $100 获得 +10%。充值 $200 获得 +15%。这降低了您的有效成本。错误免费。拒绝免费。您只为成功的 token 付费。

试用账户获得 $0.50。有效期为 7 天。这让你可以彻底测试 API。你可以在投入资金前验证集成情况。

流式与非流式响应

流式传输在生成时发送令牌。这降低了感知延迟。用户可以实时看到文本出现。这对于聊天界面至关重要。非流式传输等待完整响应。对于长输出来说，这可能会感觉很慢。

我们支持通过 SSE 进行流式传输。最后一个 chunk 包含 token 使用情况。这允许准确的计费跟踪。您可以优雅地处理部分响应。错误处理保持一致。

非流式传输也可用。它一次性返回完整响应。这对于批处理更简单。你根据需求选择。两种模式使用相同的端点。

函数调用支持流式传输。工具在识别时即执行。这提升了交互性。您可以尽早开始处理输入。API 会为您处理复杂性。

函数调用与结构化输出

函数调用让模型调用工具。您在请求中定义工具模式。模型返回函数调用。您的代码执行这些调用。这实现了复杂的工作流。您可以构建智能体或助手。

JSON 模式强制结构化输出。模型返回有效的 JSON。这对于数据提取非常有用。您将获得一致的格式。解析更容易。错误很少见。

诸如 temperature 和 top_p 之类的参数控制行为。停止序列限制输出。种子确保可重复性。惩罚减少重复。您拥有细粒度的控制。

工具选择可以是自动的或强制的。您可以指定模型的偏好。这能引导生成过程。它提高了可靠性。您的应用保持稳健。

常见的客户端库和 SDK

大多数 SDK 只需少量修改即可使用。你只需更新 base URL，其余代码保持不变。这适用于 Python、Node.js 等。集成过程非常直接。

OpenAI SDK 是标准。它处理身份验证和重试。您传递 API 密钥。基础 URL 指向我们的服务。请求正常发送。

所有 SDK 都支持流式传输。你遍历数据块。Token 使用情况在最后一个数据块中可用。这符合我们的计费模式。错误被一致捕获。

函数调用已内置于现代 SDK 中。您传入工具定义。SDK 解析响应。您的代码执行工具。循环继续直到完成。它高效且可靠。

排查常见 API 错误

速率限制返回 429 错误。您可以每分钟发送 300 次请求。超过此限制将触发等待。实现指数退避。这可以防止使服务器过载。

无效的密钥返回 401 错误。检查您的 API 密钥。确保其处于活动状态。如有需要请替换它。每个账户有一个密钥。如果丢失，请生成一个新的。

JSON 模式下的错误。请确保您的 schema 有效。模型必须返回有效的 JSON。如果失败，请重试。调整温度以提高稳定性。

长生成过程会导致超时。增加您的超时值。流式传输可降低超时风险。部分响应会被处理。您可以重构完整输出。

下一步：获取您的第一个 API 密钥

访问注册页面。使用 Google 或电子邮件。无需电话号码。流程快速。您将获得即时访问权限。

您的 API 密钥已显示。安全复制它。在您的 SDK 中使用它。将基础 URL 设置为我们的端点。开始发送请求。

仅支持加密货币充值。我们接受 USDT 或 USDC。大额充值享额外赠金。赠金永不过期。按您的节奏使用。

使用试用额度进行测试。它持续 7 天。验证流式传输和函数调用。探索模型的功能。将其集成到您的应用中。API 已准备好用于生产环境。