5 步驟使用 OpenAI 相容 API
使用 OpenAI 風格的 API 需要五個步驟:取得金鑰、安裝 SDK、指向正確的 Base URL、指定模型並發送訊息。以下是每個步驟的程式碼範例,你可以直接複製貼上。

重點摘要
- 一旦你將基礎 URL 更改為 https://api.uncensoredaiapis.com/v1 並使用你自己的金鑰,任何 OpenAI SDK 都可以在此使用。
- 模型 ID 為 uncensored;主要路由為 POST /v1/chat/completions 和 GET /v1/models。
- 串流、JSON 模式和工具呼叫使用與官方 API 相同的參數。
- 定價為每 1M 輸入 token $0.15 和每 1M 輸出 token $0.50,你可以從 $0.50 的試用額度開始。
簡短版本
如果你想了解如何使用 openai api 呼叫非 OpenAI 的服務,答案是請求格式是一種共享的慣例。一個能處理該格式的客戶端需要三個值:發送請求的位置(基礎 URL)、你的身分(金鑰)以及要運行的模型。更改這三個值,相同的程式碼即可運作。本網站遵循該慣例,因此標準的 OpenAI Python 和 Node 套件,以及純 curl,都可以對其進行操作。
清楚了解這意味著什麼以及不意味著什麼。相容意味著介面匹配。這不意味著這是官方的 OpenAI 服務,也不意味著它運行 OpenAI 的模型。後端是一個開放權重模型,由獨立供應商運營,並針對合法成人用途進行調整以無審查地回答,你可以透過模型 ID uncensored 選擇它。它僅處理文字:沒有圖片、音訊、嵌入或微調。
以下五個步驟大約需要十分鐘。如果你更喜歡閱讀多種語言的已完成程式碼片段,請參見 程式碼範例頁面。
步驟 1:取得金鑰
使用 Google 或電子郵件與密碼註冊,並開啟 API 金鑰頁面。新用戶可以一鍵領取 $0.50 的試用額度。有效期為 7 天,每人限領一次,且不需要卡片。複製金鑰並將其儲存為環境變數,而不是將其貼入程式碼中:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"試用金鑰限制為 2 個並行請求和每分鐘 60 個請求。已儲值的金鑰允許 8 個並行請求和每分鐘 300 個請求。試用包含的詳細資訊位於 免費試用 FAQ。
步驟 2:安裝 SDK 並發送第一個請求
安裝你所用語言的官方套件。這兩個套件與你用於任何 OpenAI 相容服務時使用的庫相同:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openai現在進行 Python 的第一次呼叫。與預設設定唯一的區別是 base_url 參數:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)Node 中的相同呼叫:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);步驟 3:理解訊息陣列
聊天模型在呼叫之間不會記住任何內容。每個請求都包含整個對話作為訊息列表,且每個訊息都有角色。
system設定行為和風格。在此放置人格、格式規則和限制。user包含使用者提出的問題。assistant包含模型的先前回覆。當你要繼續對話時,你需要自行新增這些內容。tool攜帶函式呼叫的結果,如下所述。
要繼續對話,請將助手的回覆和下一個使用者訊息附加到同一列表中,然後再次發送。這就是為什麼長對話成本更高:每次呼叫都為完整歷史記錄作為輸入 token 付費。上下文視窗總共包含 100,000 個 token(提示詞和補全內容合計),因此修剪舊的對話輪次是建構聊天應用程式的常規部分。
有用的採樣欄位會通過:temperature、top_p、stop、seed 以及頻率和存在性懲罰。max_tokens 是可選的。當你希望限制回覆長度和支出時,請設定它。
步驟 4:串流輸出、JSON 模式和工具
串流輸出
新增 stream: true 以接收伺服器發送的事件形式的 token。這會讓介面感覺很快,因為文字在模型仍在撰寫時就會出現,並且用量會在串流結束時報告。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}JSON 模式
當你的程式碼解析回覆時,使用 response_format: {"type": "json_object"}。也在提示詞中描述所需的鍵。
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'函式呼叫
傳遞包含函式定義的 tools 列表,以及可選的 tool_choice。當模型想要執行函式時,回覆將包含 tool_calls。你在自己的程式碼中執行該函式,並將輸出作為角色為 tool 的訊息發送回去。工具呼叫也會串流輸出。這是代理程式的建構塊;使用案例頁面 展示了其價值所在。
步驟 5:了解限制、成本和錯誤
超過限制時,API 會返回 HTTP 429。錯誤代碼為 rate_limited(每分鐘請求過多)和 concurrency(同時請求過多)。臨時過載也會返回 429,並帶有 Retry-After: 5 標頭。串流請求會保留其並行槽位,直到串流結束,因此請關閉你不再讀取的串流。主體限制為 8 MB。每個回應都帶有 X-Request-Id 和 X-Balance-USD 標頭,第一個是你向支援人員引用的內容。
成本很簡單。一次包含 3,000 個輸入 token 和 700 個輸出 token 的聊天呼叫成本為 3,000 乘以每百萬 $0.15,即 $0.00045,加上 700 乘以每百萬 $0.50,即 $0.00035,總計 $0.0008。一千次此類呼叫的成本為 $0.80。失敗或被拒絕的請求不會收費,且額度永不過期。定價頁面 列出了從 $20 到 $500 的儲值選項,從 $50 起加贈 5%,從 $100 起加贈 10%,從 $200 起加贈 15%。你可以使用加密貨幣(TRC20 上的 USDT、Base 上的 USDC)進行付款(僅接受加密貨幣儲值)。
與官方 API 的差異
有三個差異值得規劃。首先,模型名稱:使用 uncensored,而不是 OpenAI 的模型名稱。其次,範圍:你僅獲得聊天補全和模型列表,因此圖像生成、語音、嵌入和微調等功能不在這裡。第三,行為:該模型經過調整,不會拒絕合法的成人請求,因此輸出可能與經過嚴格過濾的助手不同。有一條規則從不改變:禁止涉及未成年人的性內容。
幾種習慣有助於第一天的使用。將金鑰保存在環境變數中,記錄每次呼叫的 X-Request-Id,並在實驗期間設定 max_tokens,以防止失控的回覆花費超過你計劃的金額。當建構聊天介面時,請串流輸出回覆,並在歷史記錄變長時修剪舊的輪次。當建構解析輸出的管線時,請使用 JSON 模式並仍保護解析過程,因為在 token 限制處截斷的回覆無效 JSON。當程式的兩個部分同時呼叫 API 時,請將它們計入完整金鑰允許的 8 個並行請求中。
不要忘記測試的成本。幾十次使用短提示詞的實驗總成本遠低於一分錢,因此 $0.50 的試用額度非常足夠,足以讓你在學習請求格式時使用。
如果你正在遷移現有應用程式,遷移指南 將依序帶你了解各項變更。在此發送的提示詞不會用於訓練。對於大多數應用程式,遷移僅需設定頁面開頭提到的三個值以及一個模型名稱。
更多指南
問答
我需要官方的 OpenAI SDK 嗎?
你可以使用它,這是最簡單的路徑。任何 OpenAI 相容的客戶端或純 HTTP 也可以,只要支援自訂 Base URL 即可。
我應該傳送什麼模型名稱?
發送 uncensored。Base URL 為 https://api.uncensoredaiapis.com/v1
這是官方的 OpenAI API 嗎?
不是。它遵循相同的請求格式,但該模型是由獨立供應商運營的開放權重模型,且該服務與 OpenAI 分開。
一次請求的成本是多少?
輸入 token 每 1M 成本為 $0.15,輸出 token 每 1M 成本為 $0.50。一次包含 3,000 個輸入 token 和 700 個輸出 token 的請求成本約為 $0.0008。
我可以先試用再付費嗎?
是的。註冊後,你可以一鍵領取 $0.50 的試用額度。有效期為 7 天,無需信用卡。