API 文件 & 快速入門

驗證與 Base URL

在儀表板生成您的 API 金鑰。我們使用標準的 OpenAI 相容標頭，因此您只需更新您的 base_url 和 API_KEY 變數。這可確保您現有的 SDK 整合無需修改即可運作。我們支援 Google 登入或電子郵件/密碼註冊，且您的金鑰在建立後會立即顯示。

• 基礎 URL： https://api.routeropen.cc/v1
• Auth Header： Authorization: Bearer YOUR_API_KEY

保持您的金鑰安全，因為它控制您的預付信用額度。每個帳戶一次僅允許一個有效金鑰；生成新金鑰會立即取代舊金鑰。

首次請求

使用標準的 chat/completions 端點。模型 ID simply 為 uncensored. 此服務接收文字輸入並回傳文字輸出，針對合法成人用途無內容過濾。

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

此請求展示了基本結構。您可以調整參數，例如 temperature 或 top_p 控制創造力。回應包含 token 用量統計，以確保計費透明。

Python SDK 集成

使用官方的 OpenAI Python 函式庫整合我們的 API。將客戶端指向我們的 base URL 並使用您的 API 金鑰。此方法與已經針對 OpenAI 的現有程式碼庫無縫運作。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.routeropen.cc/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)

程式庫會自動處理 JSON 序列化與串流。您可以根據需要設定重試邏輯與超時時間。我們的端點支援標準參數，因此從其他供應商遷移變得輕而易舉。

Node SDK 整合

對於 JavaScript 開發者，Node SDK 只需進行少量變更即可運作。設定 baseURL 至我們的端點並提供您的金鑰。這讓您在存取無審查模型時，能維持目前的開發工作流程。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.routeropen.cc/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);

Node 用戶可以利用 async/await 模式實現簡潔的代碼。回應結構符合 OpenAI 標準，確保與現有解析器的兼容性。只需更改兩個變量即可切換模型或供應商。

串流回應

在請求主體中將 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)

最後一個 chunk 包含請求的總 token 使用量以進行帳單。串流支援所有參數，包括函式呼叫。這非常適合需要即時回饋的聊天介面。錯誤仍會以 SSE 事件返回，因此您可以優雅地處理失敗。

限制、錯誤與上下文

我們的 API 實施 100,000 令牌的上下文視窗和 8MB 的請求體限制。您可以每分鐘對每個金鑰發送 300 次請求。如果超過此限制，您將收到 429 速率限制錯誤。身份驗證失敗返回 401，信用額度不足返回 402。

錯誤不會消耗您的預付信用額。如果您發送格式錯誤的請求，您無需付費。模型會拒絕涉及未成年人的請求，但 otherwise 允許不受限制的內容。請保持強大的錯誤處理機制以有效管理速率限制。