OpenAI 相容 API：三行程式碼切換客戶端

先決條件：安裝 OpenAI SDK

在發送請求之前，請確保您的開發環境已為首選語言安裝了官方的 OpenAI SDK。這是開發人員與 OpenAI 相容 API 互動的標準方式，確保一致的類型和錯誤處理。對於 Python，請使用 pip install openai。對於 Node.js，請執行 npm install openai。這些程式庫處理底層 HTTP 細節，讓您可以專注於傳遞提示詞並接收文字輸出。

配置基礎 URL 和 API 金鑰

我們服務的核心優勢在於您只需更新兩個設定值。將您的客戶端指向我們的基礎 URL：https://api.openaicompatibleapi.com/v1。然後，在註冊頁面產生您的 API 金鑰；註冊後立即顯示，無需信用卡。在客戶端初始化時設定 base_url 和 api_key。這使我們成為現有專案的直接 GPT API 替代方案，無需重寫邏輯。

發送您的第一個請求

使用模型 ID uncensored 發送標準的聊天補全請求。該模型是一個開放權重大型語言模型，經過調校以在法律允許的成人用途下無內容拒絕地回答。它不是 GPT、Claude 或其他廠商的模型。您可以透過簡單的文本提示詞立即測試連線。回應將在 content 欄位中返回生成的文字。

Copycurl https://api.openaicompatibleapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

啟用串流回應

為了獲得更好的使用者體驗，請啟用串流以接收生成的 token。在請求中設定 stream=True。SDK 將在收到時產生區塊，讓您可以立即顯示部分結果。這對於長達 100,000 token 的上下文視窗特別有用。串流運作方式與標準 OpenAI 客戶端相同，保持與現有錯誤處理邏輯的相容性。

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)

使用工具呼叫（函式呼叫）

我們的 API 支援結構化工具呼叫。在 tools 參數中定義您的函式，模型將在回應中返回工具呼叫。然後您可以執行這些工具並將結果發送回模型以進行進一步推理。此功能適用於支援標準工具呼叫格式的任意 OpenAI 相容客戶端。它非常適合建構代理程式或自動化工作流程，無需管理複雜的 LLM 代理。

Copyfrom openai import OpenAI

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

檢查可用模型

查詢 GET /v1/models 端點以驗證可用模型。您將看到 uncensored 模型已列出。這確認您的 API 金鑰與基礎 URL 設定正確。您也可以使用此端點來除錯驗證問題。如果端點回傳清單，表示您已連線至開發人員的 AI API。不提供其他模型，使設定保持簡潔。

Node.js

Copyimport OpenAI from "openai";

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