OpenAI 相容 API 端點:支援項目
此服務支援的 OpenAI 相容 API 端點列表,包含每個端點的有效請求,以及明確的缺失項目清單。
重點摘要
- 五個路徑:聊天完成、回應、模型與兩個餘額路徑。
- 模型 ID 為 uncensored,且一個金鑰可與任何 OpenAI SDK 搭配使用。
- 無影像、音訊、影片、嵌入或微調。
- 限制會回傳 HTTP 429 與明確的錯誤程式碼。

端點一覽
供應商真正實作了哪些 OpenAI 風格路徑?以下是此 API 的簡短清單。Base URL:https://api.uncensoredendpoint.com/v1。驗證為每次呼叫的 bearer key。
| 方法與路徑 | 目的 |
|---|---|
POST /v1/chat/completions | 聊天請求、串流輸出、工具、JSON 模式 |
POST /v1/responses | 較新的 Responses 風格請求格式 |
GET /v1/models | 列出模型;ID 為 uncensored |
GET /v1/dashboard/billing/credit_grants | OpenAI 風格的餘額格式 |
GET /v1/balance | 簡易格式的餘額 |
這就是全部的功能範圍。表格中未列出的項目皆不提供。繼續閱讀有效請求與缺失清單,以便你在寫程式前進行規劃。
聊天完成
這是大多數客戶使用的端點。將任何 OpenAI SDK 指向 Base URL 並使用模型名稱 uncensored。
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "List three uses of a webhook."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)支援的參數包括 stream、tools、tool_choice、response_format 搭配 json_object,以及採樣設定:temperature、top_p、stop、seed與懲罰參數。max_tokens 為選填,因為完成請求可使用 100,000 token 上下文視窗中剩餘的任何數量。
使用 stream: true 時,回覆以伺服器發送事件形式到達,並在結尾包含用量,因此你仍可記錄 token 計數。
多輪對話
API 不保留對話狀態。對於多輪聊天,你每次需傳送完整的訊息列表:系統訊息在前,接著是交替的使用者與助手輪次。這意味著輸入 token 會隨每次輪次增加,成本也會隨之增加,因此對話變長時應修剪或摘要舊輪次。上下文視窗為 100,000 token(提示詞與完成內容的 token 總和),對大多數聊天已足夠,但貼上文件很容易填滿。
回應、模型與餘額
回應
較新的 OpenAI 範例使用 /v1/responses。此處也提供,因此為此格式編寫的程式碼無需重新編寫。
curl https://api.uncensoredendpoint.com/v1/responses \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "input": "Write a haiku about caching."}'使用你的客戶所預期的格式。如果你是從頭開始,聊天完成端點擁有最廣泛的工具支援。
模型與餘額
列出模型以檢查你的金鑰是否有效。你應該會看到單一項目 uncensored,因為該服務運行單一模型,並非跨供應商的路由器。
curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"
# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"
# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"你也會在回應的 X-Balance-USD 標頭中取得餘額,這對於在應用程式中顯示低額度警告很有幫助,且無需額外請求。其他標頭包括用於支援問題的 X-Request-Id,以及 X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency。
工具與 JSON 模式實作
兩個功能將聊天端點變成可建構產品的基礎。工具呼叫讓模型要求你的程式碼執行函式。JSON 模式讓模型回傳可解析的輸出。兩者皆使用標準請求欄位。
工具呼叫如下所示。模型回傳 tool_calls 項目,你執行函式,然後以 role: "tool" 訊息形式回傳結果。
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)
msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)對於 JSON 模式,新增 response_format={"type": "json_object"} 並在提示詞中說明你想要 JSON,最好包含你預期的鍵。始終在 try 區塊內解析:沒有模型保證每次呼叫的結構,因此請在信任結果前先驗證。
將現有的 OpenAI 專案遷移
如果你的應用程式已使用 OpenAI SDK,遷移只需三個編輯且無需新函式庫。大多數 SDK 讀取相同的兩個環境變數,因此你通常無需更改程式碼。
export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEYimport OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);然後在程式碼中搜尋模型名稱(如 GPT 模型 ID)並將其替換為 uncensored,因為該服務只有一個模型。移除對嵌入、影像或音訊的呼叫,並將這些路由至其他供應商。保留簡短檢查清單:Base URL 已更改、模型名稱已更改、金鑰儲存於環境變數而非儲存庫、429 重試邏輯,以及基於餘額標頭的低額度警報。關於金鑰設定,請參見 如何取得 uncensored AI API 金鑰。然後執行單一測試請求,並確認 X-Balance-USD 回傳後,再切換真實流量。
未提供項目
了解缺失可節省一天的除錯時間。此 API 僅限文字。以下 OpenAI 端點不可用:
- 圖像與視覺生成。 不提供圖像生成或編輯。
- 音訊。 無語音轉文字或文字轉語音。
- 影片。 未提供。
- 嵌入。 若建構檢索,你需要單獨的嵌入服務。
- 微調。 你無法在該服務上進行訓練。
呼叫這些路徑會失敗,因此請將它們排除在任何共用客戶端設定之外。典型設定將此 API 用於聊天,並搭配另一個供應商處理嵌入,你的應用程式會根據任務選擇 Base URL。
限制、錯誤與重試
完整金鑰允許 8 個並行請求和每分鐘 300 個請求。試用金鑰允許 2 個並行和每分鐘 60 個請求。最大主體為 8 MB。當你超過限制時,你會收到 HTTP 429 與指出哪一項的錯誤程式碼:rate_limited 用於每分鐘請求數,concurrency 用於同時請求過多。暫時超載時你也會收到 429,帶有 Retry-After: 5 標頭。
一個細節常讓人措手不及:串流請求會在其串流結束前佔用其並行槽位,因此慢速讀取者會佔用限制。簡單的包裝重試器可處理所有情況:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
def ask(prompt, tries=4):
for i in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (i + 1))
raise RuntimeError("still rate limited")失敗或拒絕的請求不會收費,因此錯誤重試不會產生額外費用。對於批次作業,將工作池上限設為完整金鑰的 8 或試用金鑰的 2,而不是依賴重試。固定池較易推理,且可防止單一慢速串流餓死其他串流。
成本與存取
價格為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50,從預付額度扣除,無訂閱且永不過期。以 $20 至 $500 的整數金額儲值,可透過加密貨幣(TRC20 上的 USDT、Base 上的 USDC)進行。較大的儲值金額享有額外贈額:$50 起贈加 5%、$100 起贈加 10%、$200 起贈加 15%。請見價格頁面。
若要試用,請使用 Google 或電子郵件註冊,然後在API 金鑰頁面上一鍵領取 $0.50 免費試用額度。文件涵蓋每個參數,端點總覽則說明該服務的內容:單一開放權重模型,適用於合法成人用途,無內容審查,並嚴格禁止涉及未成年人的性內容。
更多指南
問答
是否支援串流輸出與函式呼叫?
是。使用 stream: true 進行伺服器發送事件並在結尾取得用量,並搭配 tool_choice 進行函式呼叫。
有嵌入端點嗎?
不行。該服務僅提供文字聊天,因此嵌入服務請使用其他供應商。
我如何檢查餘額?
呼叫 GET /v1/balance 或 OpenAI 風格的 credit_grants 路徑,或讀取任何回應中的 X-Balance-USD 標頭。
當我達到速率限制時會發生什麼事?
你會收到 HTTP 429,錯誤碼為 rate_limited 或 concurrency。請等待並重試;在暫時過載時,Retry-After 標頭會顯示 5 秒。
只差一張表單,即可取得金鑰
建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。