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

5 步驟使用 OpenAI 相容 API

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

更新於

五個發光的墊腳石通向伺服器方塊,說明使用 OpenAI 風格 API 的起始步驟

重點摘要

  • 一旦你將基礎 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 天,無需信用卡。

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

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