基礎 URL 與驗證
我們的 API 位於 https://api.huggingfacellmapi.com/v1. 使用 Authorization 標頭。透過 取得 API 金鑰 使用 Google 或電子郵件登入頁面。請妥善保管此金鑰;任何擁有此金鑰的人都可以消耗您的預付額度。如果您遺失了它,請生成新的金鑰以取代舊的有效金鑰。無需提供手機號碼即可開始使用。
首次使用 cURL 的請求
發送原始 JSON 有效載荷以立即測試端點。使用模型 ID uncensored 繞過標準過濾器。以下 cURL 命令演示了基本的文本生成請求。
curl https://api.huggingfacellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the release notes for version three point zero five"}]
}'此請求回傳一個包含生成文字的 JSON 物件。請檢查 choices 實際內容的陣列。如果您收到 401 錯誤,請驗證您的金鑰是否正確且有效。
Python SDK 集成
使用官方 openai 提供乾淨介面的 Python 函式庫。將客戶端指向我們的基礎 URL 並設定您的 API 金鑰。此方法會自動處理重試和 JSON 解析。
from openai import OpenAI
client = OpenAI(base_url="https://api.huggingfacellmapi.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)透過 pip 安裝套件。接著即可像使用 OpenAI 一樣呼叫聊天完成端點。回應物件可讓您取得 token 用量與結束原因。
Node.js 客戶端設置
JavaScript 開發者可以使用 openai Node 套件。使用我們特定的基礎 URL 配置客戶端。這確保所有請求都通過我們的無審查伺服器路由。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.huggingfacellmapi.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 環境中執行此程式碼片段。它演示了一個簡單的同步呼叫。您可以輕鬆地將其整合到 Express 路由或無伺服器函式中。
串流回應
在請求主體中將 stream: true. 伺服器發送包含部分 Token 的伺服器發送的事件 (SSE)。這降低了最終使用者的感知延遲。
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)逐區塊解析。最後一個區塊包含請求的總 token 用量。這對於構建即時打字顯示回應的聊天介面非常有用。
限制、錯誤與上下文
提示與補全的上下文視窗總計為 100,000 個 token。每次請求最多可請求 16,000 個輸出 token。401 錯誤表示金鑰無效,402 錯誤表示信用不足。速率限制將每分鐘請求上限設為 300 次。超過 8 MB 的請求將被拒絕。處理期間的錯誤不會消耗您的信用額度。