OpenAI 相容端點快速入門指南

前置條件：Python 或 Node.js

安裝官方 openai 套件到您的執行環境，然後再繼續。

Python 使用者需要版本 1.0.0 或更高版本。Node 開發者需要版本 4.0.0 或更新版本。兩個版本都支援標準的 chat-completions 結構。

無需額外依賴。SDK 會自動處理 JSON 序列化和 HTTP 傳輸。

配置 base_url 和 API 金鑰

將您的 SDK 客戶端指向我們的基礎 URL 並提供您產生的金鑰。

使用 https://api.openaicompatibleendpoint.com/v1 作為基礎 URL。將 API 金鑰設為您儀表板上顯示的值。

• Python： base_url="https://api.openaicompatibleendpoint.com/v1"
• Node： baseURL: "https://api.openaicompatibleendpoint.com/v1"

此設定可與任何 OpenAI SDK 相容的用戶端搭配使用。您的其餘邏輯無需進行任何程式碼變更。

傳送您的第一個聊天補全

向 POST 請求 /v1/chat/completions 搭配您的系統和使用者訊息。

模型 ID 為 uncensored. 該模型針對合法成人或爭議性主題不拒絕回答。

• 上下文窗口：總計 100,000 tokens。
• 最大輸出：16,000 個 token。

立即發送您的提示詞並接收文字輸出。無錯誤且無拒絕。僅實際的 token 使用量會從您的預付額度中扣除。

啟用串流和函式呼叫

在請求主體中將 stream: true 在您的請求參數中。

Token 用量包含在串流的最後一個區塊中。這使您能夠即時追蹤成本。

完全支援函式呼叫。使用 tools 用於定義您的結構描述。模型返回結構化的工具調用，您可以在應用程式邏輯中執行。JSON 模式也可透過 response_format.

處理錯誤與 token 限制

API 針對常見問題回傳標準 HTTP 狀態碼。

• 401：無效的 API 金鑰。請檢查您的儀表板。
• 402：額度不足。請使用 USDT 或 USDC 充值。
• 429：超過速率限制。您每分鐘允許 300 次請求。

如果您超過 16,000 token 的輸出限制，回應將被截斷。上下文視窗包含提示和完成 token。

定價與限制

僅為實際用量付費。輸入令牌每百萬計費 $0.15。輸出令牌每百萬計費 $0.50。

預付額度永不過期。不發給退費，但重複扣款可透過支援頁面修正。

僅使用加密貨幣充值。可接受的貨幣為 USDT (TRC20) 和 USDC (Base)。最低充值金額為 $20。贈送餘額範圍從 +5% 到 +15%，取決於金額。

cURL

Copycurl https://api.openaicompatibleendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return list of supported file formats"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

串流

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)