API 文档

基础 URL 和认证

API 端点位于 https://api.openrouteraiapi.com/v1。将您的 API 密钥放在 Authorization 作为 bearer 令牌。此 header 是将流量从当前提供商重定向到我们无审查模型所需的唯一更改。

认证很严格。如果密钥缺失或无效，服务器将立即返回 401 错误。您可以通过仪表板上的 Google 或电子邮件即时生成密钥。请妥善保管密钥，因为它可以访问您的预付费余额。

聊天完成端点

发送 POST 请求至 /v1/chat/completions 带有 messages 数组。模型标识符为 uncensored. 单一模型处理您的所有文本生成需求，无需复杂的路由逻辑。

以下是使用 cURL 的标准请求，用于验证连通性和响应格式。

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

响应包含 choices[0].message.content 字段。您可以将其直接解析到您的应用程序工作流中。

Python SDK 集成

使用官方 OpenAI Python 客户端轻松连接。设置 base_url 和 api_key 变量以指向我们的基础设施。这种方法在切换提供商时最大限度地减少了代码更改。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouteraiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

客户端自动处理序列化和重试。您收到一个包含文本和 token 使用统计信息的补全对象。此方法非常适合后端服务和脚本。

Node.js SDK 用法

使用您的自定义基础 URL 初始化 OpenAI Node.js 客户端。这允许 JavaScript 应用程序使用熟悉的方法与 uncensored 模型交互。SDK 高效管理 HTTP 请求。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouteraiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

调用 chat.completions.create() 附带您的消息。响应对象提供对生成内容和用法数据的访问。此集成非常适合 Web 服务器和边缘函数。

流式响应

通过将 stream: true 在你的请求中。服务器返回服务器发送事件 (SSE) 以实现实时 token 传输。此功能降低了最终用户的感知延迟。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

每个块包含部分内容。最后一个块包含完整的令牌使用情况统计信息。在客户端处理这些事件以增量更新 UI。

限制、错误和上下文窗口

上下文窗口支持 100,000 个 token，用于合并的输入和输出。每次请求最多可输出 16,000 个 token，如果 max_tokens 未设置。速率限制允许每个密钥每分钟 300 次请求。

错误是标准 HTTP 代码。401 表示密钥无效。402 表示您的预付余额已耗尽。429 表示您已超过速率限制。失败的请求不消耗余额。错误是免费的。