繁中 ▾
Base URL https://api.uncensoredaiapis.com/v1模型 uncensored
取得 API 金鑰
Uncensored AI遷移指南

從 OpenAI 或 OpenRouter 遷移至無審查 AI API

透過在小型測試客戶端中更改 base URL、API 金鑰與模型 ID 來啟動遷移。在切換生產環境流量前,請先執行您預先儲存的一組提示詞:相容的請求格式並不意味著會產生相同的結果。本指南涵蓋配置、串流、工具呼叫,以及在 LangChain 或 LlamaIndex 中需重複執行的檢查項目。

從 OpenAI 或 OpenRouter 遷移至無審查 AI API

更新於

重點摘要

  • 僅變更三個值:Base URL https://api.uncensoredaiapis.com/v1, 您的新金鑰,以及模型 "uncensored"。
  • 聊天完成、串流輸出與函式呼叫採用 OpenAI 格式;嵌入、圖片、音訊與微調則不存在。
  • 將 Base URL、金鑰與模型放入環境變數,讓舊版與新版後端並行運作,回滾只需替換一個檔案。
  • 明確設定 max_tokens,並在切換前規劃 100,000 token 的上下文視窗。

切換時會發生什麼變化

如果您的應用程式已與 OpenAI 或 OpenRouter 聊天完成 API 通訊,遷移至此無審查 AI API 僅是設定變更,無需重寫。僅有三個值會變更,請求程式碼中的其餘部分保持不變:Base URL、API 金鑰與模型名稱。

設定切換前切換後
Base URLOpenAI 或 OpenRouter 的 URLhttps://api.uncensoredaiapis.com/v1
驗證來自您目前服務的金鑰來自 您的帳戶這裡 的金鑰,以 Authorization: Bearer <key> 傳送
模型模型 ID,例如 GPT 或路由模型名稱uncensored
端點/chat/completions相同:POST /v1/chat/completions

僅有一個模型,因此沒有模型目錄可供選擇。GET /v1/models 端點存在並列出該模型,這可讓依賴此端點的 SDK 輔助工具和健康檢查繼續運作。訊息、串流輸出和函式呼叫均使用你已慣用的 OpenAI 格式。本頁為實作指南;若需與 OpenRouter 的成本、延遲和隱私比較,請閱讀 OpenRouter 無審查模型文章。

以下是最小化的 Python 差異。呼叫中的其餘部分不會變更。

import os
from openai import OpenAI

# before
# client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
# model = "gpt-4o"

# after
client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)
model = "uncensored"

resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)
print(resp.choices[0].message.content)

對於 OpenRouter 使用者,情況相同:取代 OpenRouter Base URL 與金鑰,並移除您透過標頭或請求主體傳遞的任何路由特定額外參數(見下方的相容性表格)。

參數與功能相容性

聊天應用程式的關鍵表面已涵蓋。表格區分了哪些文件標示為支援、哪些應在依賴前透過測試呼叫確認,以及哪些完全不存在。若有疑問,請在 staging 環境發送請求並比較回應,而非假設與其他服務相容。

項目狀態碼備註
model支援使用 uncensored。僅有一個模型。
messages(system、user、assistant、tool 角色)支援標準 OpenAI 訊息格式。上下文視窗為 100,000 token,包含提示詞與補全。
max_tokens支援最多可達 100,000 個 token 的上下文視窗。
stream: true支援伺服器發送事件。最終使用量區塊會自動新增。
tools、tool_choice、角色 tool 訊息支援OpenAI 函式呼叫格式。
採樣與停止選項(temperature、top_p、stop,以及類似選項)支援標準 OpenAI 欄位,按原樣傳遞。切換後需重新調整 temperature:相同的值在新模型上可能感覺不同。
路由額外參數:備用模型列表、路由偏好、應用程式歸屬標頭不可用僅有一個模型,因此無需路由。請從請求與設定中移除這些項目。
嵌入不可用為 RAG 管線保留獨立的嵌入來源。
圖片生成、視覺、音訊、影片不可用此 API 僅支援文字。
微調不可用無微調端點。請透過系統提示詞調整行為。

實際影響是,使用嵌入進行檢索的管線需要兩個客戶端:一個用於您現有的嵌入服務,另一個用於此處的生成。這是正常的分割,下一節的環境變數方法可保持整潔。

使用環境變數並行運行

最安全的遷移方式讓兩個後端保持運行,並在執行時選擇其中一個。將三個不同的值放入環境變數,並在單一位置讀取。然後您可以將開發環境、部分流量或單一功能路由至新 API,而無需分支請求程式碼。

# .env.openai
LLM_BASE_URL=your-current-base-url
LLM_API_KEY=paste-your-existing-key
LLM_MODEL=gpt-4o

# .env.uncensored
LLM_BASE_URL=https://api.uncensoredaiapis.com/v1
LLM_API_KEY=paste-your-key-here
LLM_MODEL=uncensored

接著,單一程式庫即可建構用戶端:

import os
from openai import OpenAI

def make_client() -> tuple[OpenAI, str]:
    client = OpenAI(
        base_url=os.environ["LLM_BASE_URL"],
        api_key=os.environ["LLM_API_KEY"],
    )
    return client, os.environ["LLM_MODEL"]

client, model = make_client()
resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(model, "->", resp.choices[0].message.content)

Node.js 中的相同模式:

import OpenAI from "openai";

export function makeClient() {
  const client = new OpenAI({
    baseURL: process.env.LLM_BASE_URL,
    apiKey: process.env.LLM_API_KEY,
  });
  return { client, model: process.env.LLM_MODEL };
}

const { client, model } = makeClient();
const resp = await client.chat.completions.create({
  model,
  messages: [{ role: "user", content: "Reply with the single word: ready" }],
  max_tokens: 10,
});
console.log(model, "->", resp.choices[0].message.content);

要比較行為,請對兩種設定執行相同的提示詞集,例如在測試指令前執行 set -a; source .env.uncensored; set +a。由於變數名稱是通用的,當您最終停用舊後端時,不需要更動程式碼,而回滾只需替換一個檔案。

LangChain、LlamaIndex 和其他 OpenAI 相容的用戶端

任何允許你覆寫 OpenAI base URL 的框架都能與此 API 搭配使用,因為 HTTP 合約相同。你需傳遞 base URL、金鑰和模型名稱;框架會處理其餘部分。對於 LangChain,langchain_openai 套件提供了 ChatOpenAI:

import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
    model="uncensored",
    max_tokens=500,
)

print(llm.invoke("Give me a one-line pitch for a noir detective game.").content)

對於 LlamaIndex,請使用 llama-index-llms-openai-like 套件中的 OpenAI 相容 LLM 類別,該套件適用於實作聊天補全格式但非 OpenAI 本身的伺服器:

import os
from llama_index.llms.openai_like import OpenAILike

llm = OpenAILike(
    api_base="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
    model="uncensored",
    is_chat_model=True,
)

print(llm.complete("Give me a one-line pitch for a noir detective game."))

在框架設定中需注意兩件事。首先,呼叫嵌入模型的檢索功能仍需不同的嵌入來源,因為此 API 不提供此功能。其次,框架有時會根據內部列表中的模型名稱來決定上下文視窗大小或函式呼叫支援;若看到未知模型的警告,這僅是介面顯示問題,但請確認框架假設的上下文視窗未超過 100,000 token。不同函式庫的參數名稱略有差異(base_url、api_base、baseURL),請確認你的函式庫使用的名稱。其他接受自訂 OpenAI base URL 的工具(如編輯器外掛和聊天前端)也遵循相同的三個值模式。

切換前的測試清單

在 staging 環境中逐一檢查此清單。每項操作都很快速,加總起來可捕捉大多數遷移時的意外狀況。

  1. 驗證與路由。 使用你的金鑰呼叫 GET /v1/models。401 表示金鑰或標頭有誤;404 表示路徑有誤。
  2. 基本補全。 傳送一行提示詞,設定 max_tokens,並確認存在 choices[0].message.content 和 usage。
  3. 串流輸出。 使用 stream: true 執行你的實際 UI 路徑。確保你的解析器能處理包含空 choices 列表的最終用量區塊。
  4. 工具呼叫。 執行完整往返:請求、tool_calls、role tool 回覆、最終答案。檢查你的程式碼是否能處理沒有工具呼叫的回覆。
  5. 長提示詞。 傳送接近你實際上限的提示詞。提示詞加上 max_tokens 超過 100,000 時回應會在視窗末尾停止;只有提示詞本身超過 100,000 才會回傳 400。
  6. 錯誤處理。 模擬錯誤金鑰(401)。確認應用程式讀取 JSON error.code,並妥善處理 402 no_credit、403 content_blocked、429 和 503 upstream_busy。
  7. 輸出品質與語氣。重放真實提示詞的樣本,並與當前模型的回應進行比較。針對其他模型的拒絕或保留語氣進行調整的提示詞,可能需要簡化。
  8. 成本追蹤。 記錄 usage。輸入為每百萬 token $0.15,輸出為每百萬 token $0.50,因此你可根據現有的 token 計數輕鬆重新計算估算值。

串流輸出、工具呼叫和重試步驟的可執行版本,請參見 程式碼範例頁面。

常見陷阱

保留舊模型名稱。 最常見的失敗是請求仍指定了其他模型 ID。請從設定檔讀取模型(如環境變數範例所示),使其與 base URL 一起移動。

傳送舊金鑰。 來自其他服務的金鑰會回傳 401。此處的金鑰與單一帳戶綁定,每個帳戶一個金鑰,且重新產生金鑰會立即使舊金鑰失效,因此重新產生後請更新所有部署。

base URL 缺少 /v1。 base URL 必須以 /v1 結尾。SDK 會自行附加 /chat/completions;若 base URL 缺少此後綴,會產生 404 錯誤。

依賴不存在的功能。 嵌入、圖片、音訊和微調請求將會失敗。在切換前請檢查程式碼庫,而非切換後。

忽略輸出上限。 若未設定 max_tokens,回應可能會持續至上下文視窗結束。若其他服務預設會產生更長的回應,請明確設定值,因為較小的上限可能會導致回應因 finish_reason: length 而提前結束。

上下文溢位。 若你目前的模型具有更大的視窗,長歷史記錄可能超過 100,000 token 的提示詞與補全總和,並回傳 400。請在切換前加入截斷或摘要功能。

重試所有請求。僅重試 429 和 503。402 表示餘額已用完或試用期已過,重試無效。請儲值並繼續,詳情請見 定價頁面。

內容規則。 合法的成人內容和小說不會被拒絕,但涉及未成年人的性內容一律會以 403 封鎖,包括小說和角色扮演。該服務僅供成人和合法用途,因此請確保你的產品在相關情況下執行年齡限制。

問答

從 OpenAI 切換時,我必須重寫程式碼嗎?

通常不需要。在您的客戶端設定中,將 base_url、api_key 和模型名稱更改為 uncensored。訊息格式、串流輸出和函式呼叫遵循相同的 OpenAI 格式。

我可以同時繼續使用 OpenRouter 和此 API 嗎?

可以。從環境變數讀取 Base URL、金鑰和模型,並將每個環境或功能指向您想要的後端。在漸進式遷移期間,兩者可以並行運行。

我的嵌入或圖片請求會發生什麼事?

它們在此無法運作。此 API 僅限文字,沒有嵌入、圖片、音訊、影片或微調功能,因此請為這些功能保留單獨的來源。

LangChain 能與此無審查 AI API 搭配使用嗎?

可以。使用 langchain_openai 的 ChatOpenAI,將 base_url 設為 https://api.uncensoredaiapis.com/v1,並將金鑰填入對應欄位,model="uncensored"。任何接受自訂 OpenAI base URL 的客戶端都遵循相同的模式。

只差一張表單,即可取得金鑰

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。