繁中 ▾
Uncensored Models取得您的金鑰

無審查 API 快速入門指南

使用基礎 URL 和 API 金鑰將您的客戶端連接到我們的託管式 OpenAI 相容 API。本指南涵蓋了快速整合所需的關鍵端點、串流傳輸和參數。

身份驗證與基礎 URL

開始將您的 SDK 指向我們的基本 URL,並在授權標頭中傳遞您的金鑰。我們提供直接、單一模型的服務,沒有代理路由費用。使用標準 Authorization: Bearer 驗證請求的機制。您的金鑰在透過 Google 或電子郵件註冊後立即產生。確保您將客戶端設定中的佔位符金鑰替換為儀表板上顯示的金鑰。基礎 URL 為 https://api.uncensoredmodelsollama.com/v1. 此端點支援標準 OpenAI 相容客戶端,允許您在無需重寫應用程式邏輯的情況下切換供應商。保持金鑰安全,因為它授予您預付信用額度餘額的存取權。

聊天完成端點

將文字請求发送至 /v1/chat/completions 用於產生回應的端點。此端點處理標準的對話歷史與系統提示。您必須將模型 ID 指定為 uncensored 請求主體中。API 返回包含生成文字和 token 使用統計資訊的 JSON 格式回應。錯誤(如信用額度不足或金鑰無效)會以適當的 HTTP 狀態碼返回。使用此端點進行所有標準文字生成任務。它不支援嵌入、影像或微調。請將您的有效負載保持在 8 MB 以下以確保可靠處理。模型在共享的上下文視窗內處理輸入和輸出 token。

串流回應

透過設定 stream 參數設為 true 在您的請求中。API 返回包含文字增量區塊的伺服器發送事件 (SSE)。此方法降低了使用者等待長輸出時的感知延遲。您在串流的最後一個區塊中收到 token 用量資訊。在您的客戶端中實作串流處理常式以有效處理這些事件。串流傳輸非常適合聊天介面和即時應用程式。確保您的客戶端程式庫支援 SSE 解析,以正確處理持續的資料流。無論是否為串流模式,總上下文視窗仍為 100,000 個 token。

函式呼叫與 JSON 模式

使用 tools 用於啟用函數調用功能。在請求主體中定義您的函數,以允許模型返回結構化資料。設定 response_format 以 {"type": "json_object"} 用於嚴格的 JSON 輸出。此功能對於提取資料或生成結構化有效載荷很有用。該模型支援工具選擇參數以控制函式呼叫行為。使用這些功能將 API 整合到自動化工作流程中。確保您的函式定義符合預期的輸入 schema 以獲得可靠的結果。API 以標準的 OpenAI 格式傳回工具呼叫,以便輕鬆解析。

參數與速率限制

使用以下參數調整生成行為: temperature, top_p,以及 seed. 設定 max_tokens 以限制輸出長度,若未指定則預設為 2,048。API 對每個金鑰實施每分鐘 300 次請求的速率限制。每個金鑰的併發請求上限為 8 次。若超過這些限制,API 將返回 429 狀態碼。請求根據實際 token 使用量收費,錯誤與拒絕的請求免費。信用額度永不過期,預付金額透明。請妥善管理您的金鑰,因為每個帳戶同時僅支援一個有效金鑰。

限制、錯誤與上下文

上下文視窗支援輸入與輸出合計 100,000 個 token。超過 8 MB 主體限制的請求將失敗。常見錯誤包括:無效金鑰導致 401,信用不足導致 402。請在應用程式邏輯中妥善處理這些錯誤。API 會拒絕包含未成年人性內容的請求,無論其他設定為何。其他內容對合法成人用途保持無審查狀態。監控您的 token 使用量以避免意外費用。預付信用系統確保您僅為實際使用的內容付費。您的整合無需訂閱費或隱藏費用。

cURL

curl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

from openai import OpenAI

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

Node.js

import OpenAI from "openai";

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

串流

stream = 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)

常見問題

無審查 Ollama 模型的基礎 URL 為何?

基礎網址為 HTTPS://api.uncensoredmodelsollama.com/v1。請透過更新 base_url 設定,使用此端點搭配任何 OpenAI 相容 SDK。此網址直接提供單一 uncensored 模型,無需透過代理路由。

如何在 Python 中處理串流回應?

在您的請求中將 stream 參數設為 true。API 會回傳包含增量文字區塊的伺服器發送事件。使用您 SDK 的串流處理常式處理這些事件,以顯示即時輸出。Token 用量資料提供在串流的最後一個區塊中。

如果我超出速率限制會發生什麼事?

當您每分鐘超過 300 個請求或 8 個並發請求時,API 會回傳 429 狀態碼。您的金鑰仍保持作用中,但在速率視窗重置前,進一步的請求將失敗。監控您的使用量,以避免應用程式工作流程中斷。

單一步驟取得金鑰

註冊、複製金鑰、更新基礎網址。完成。

取得您的金鑰