開發者的 API 文件

基礎 URL 與驗證

基礎網址為 HTTPS://api.ollamaapiurl.com/v1。請透過在 Authorization 標頭中傳遞您的唯一 API 金鑰來進行驗證。此金鑰將作為所有請求的憑證。註冊後請立即從您的儀表板取得。

• 保持您的金鑰安全。它授予您預付信用額度的完整存取權。
• 隨時從設定頁面產生新的金鑰。

我們的 API 系統很簡單。每個帳戶僅限一個有效金鑰，以確保清晰的追蹤。如果您失去存取權，可立即重新產生金鑰。無需電話號碼驗證即可阻擋您的存取。

首次請求

使用標準 HTTP 發送第一個提示詞。該端點接受文本輸入並返回文本輸出。此方法適用於您偏好的任何 HTTP 客戶端程式庫。

Copycurl https://api.ollamaapiurl.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 local library"}]
  }'

回應包含 token 使用量。您只需為處理過的 token 付費。錯誤不會消耗您的預付餘額。這種透明度讓您可以精確控制支出。

Python SDK 整合

使用官方 OpenAI Python 庫。將其 base URL 設為 uncensored。這確保您獲得無審查的行為，且無需本地設定的麻煩。

Copyfrom openai import OpenAI

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

程式庫會自動處理重試與格式化。您將取得結構化 JSON 或原始文字。也支援串流。這種方式能保持程式碼的簡潔與可維護性。

Node SDK 設置

安裝 openai 套件。將基礎 URL 配置指向我們的服務。從您的環境設定 API 金鑰。此設定與 Python 配置非常相似。

Copyimport OpenAI from "openai";

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

Node 開發人員獲得一致的行爲。模型即時響應提示詞。您可以將其整合到任何 Web 伺服器或後台工作程序中。無需複雜的路由邏輯。

串流回應

透過將 stream 設為 true 來啟用串流。API 會傳回產生的區塊。這能改善使用者的感知延遲。您可以即時顯示出現的 token。

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

最後一個 chunk 包含總 token 計數。可用於帳單驗證。串流支援所有參數。它也支援函式呼叫。您的用戶可以即時看到進度。

限制、錯誤與上下文

您的上下文視窗總計為 100,000 個 token，包含提示與補完。您可以每次請求輸出最多 16,000 個 token。速率限制為每分鐘 300 次請求。每支金鑰的併發請求上限為 8 個。

常見錯誤包括 401（無效金鑰）。402 錯誤表示您的預付餘額已耗盡。429 響應表示您達到了速率限制。請查看儀表板以通過加密貨幣充值。餘額永不過期。雙重收費等錯誤可通過支援修復。