Ollama API 開發者文件

身份驗證與基礎 URL

使用 https://api.ollamaendpointurl.com/v1 作為您的基礎 URL，並將您的 API 金鑰包含在 Authorization 標頭。

• 基礎 URL: https://api.ollamaendpointurl.com/v1
• 標頭: Authorization: Bearer YOUR_API_KEY

在儀表板上透過 Google 或電子郵件立即生成您的金鑰。無需手機號碼。此 URL 適用於任何標準 OpenAI SDK，只需覆寫基礎 URL 即可。

首次請求

向以下網址發送 POST 請求 /v1/chat/completions 使用模型 ID uncensored 以及您的訊息。

Copycurl https://api.ollamaendpointurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the default port for Ollama?"}]
  }'

此請求回傳一個包含生成文字的 JSON 回應。如果您收到 401 錯誤，表示您的 API 金鑰無效。402 錯誤表示預付信用不足。

Python SDK 集成

使用您的金鑰和自訂基礎 URL 初始化客戶端以以程式方式發送請求。

Copyfrom openai import OpenAI

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

設定 max_tokens 用於控制輸出長度。若省略此參數，預設值為 2,048 個 token。該模型接受標準參數，例如 temperature 和 top_p 用於調整生成行為。

Node SDK 整合

配置 Node.js 客戶端以指向我們的端點，以便無縫集成到您的腳本中。

Copyimport OpenAI from "openai";

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

SDK 自動處理序列化。請確保您使用的是支援自訂基礎 URL 的最新版本 OpenAI SDK。錯誤會以標準 API 例外狀況形式拋出。

串流回應

在請求主體中將 stream: true 透過伺服器發送事件（SSE）接收 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)

Token 用量詳情出現在串流的最後一個數據塊中。這可降低長輸出的感知延遲。該端點支援與大多數客戶端庫相容的標準 SSE 格式。

速率限制與上下文視窗

每個 API 金鑰限制為每分鐘 300 次請求和 8 個並行請求。上下文視窗總共為 100,000 個 token。每次請求的最大輸出為 16,000 個 token。主體大小超過 8 MB 的請求將被拒絕。429 錯誤表示您已觸及速率限制。請稍候片刻後再重試。錯誤與拒絕不會消耗信用額度。信用額度永不過期。使用加密貨幣充值。以 $0.50 試用信用額度開始。立即獲取您的金鑰。