Hermes API：三行程式碼即可切換您的客戶端

安裝 OpenAI SDK

由於我們的端點與 OpenAI 相容，你可以使用你已經熟悉的官方 SDK。這種方法讓你能夠從其他供應商切換，而無需重寫應用程式邏輯。我們支援 Python 和 Node.js 環境中的標準 openai 套件。

請確保您使用的是最新版本的 SDK，以保證與串流輸出和函式呼叫功能的相容性。客戶端程式庫會自動處理 JSON 序列化和 HTTP 傳輸，因此您可以專注於模型參數，而非網路細節。

配置基礎 URL 與金鑰

驗證透過 Authorization 標頭中的 Bearer token 處理。你可以在儀表板上透過電子郵件和密碼註冊來取得金鑰。試用不需要信用卡，你可以隨時重新產生金鑰以撤銷存取權。

將基礎 URL 設定為我們的專屬端點。這可確保所有請求都發送至我們的無審查模型基礎設施，而非預設的 OpenAI 雲端。您可以在註冊後立即在「取得 API 金鑰」頁面找到您的 API 金鑰。

發送您的第一個請求

傳送標準聊天完成請求以測試連線。模型 ID 始終為 uncensored。此模型經過調整，可無審查地回答，適用於合法成人用途，非常適合創意寫作、角色扮演或無限制的研究。

• 使用 POST /v1/chat/completions 進行文字生成。
• 上下文視窗支援最多 100,000 個 token，包含提示詞與補全。
• 請求根據輸入和輸出 token 計數收費。

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

啟用串流輸出 (SSE)

為了更好的使用者體驗，請啟用串流輸出以接收生成的 token。這可降低感知延遲，特別是對於較長的回應。伺服器會返回伺服器發送的事件 (SSE)，您的客戶端可以即時解析。

在請求主體中將 stream 參數設為 true。SDK 會在資料到達時產生區塊。這對於聊天介面特別有用，你可以增量顯示文字，而不必等待整個回應完成。

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 支援函式呼叫，允許模型輸出結構化 JSON 以執行外部工具。在 tools 參數中定義你的函式，如果合適，模型會在回應中回傳 tool_calls。

此功能完全按照 OpenAI 規格文件中所述運作。您可以解析函式名稱和參數，執行後端邏輯，並將結果回饋到對話中。它完全相容標準 OpenAI SDK 的工具呼叫工作流程。

Copyimport OpenAI from "openai";

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

檢查可用模型

查詢模型端點以驗證連線並查看可用選項。目前我們提供單一專屬模型：uncensored。這種簡化避免了模型路由或通用基礎設施的複雜性，確保行為可預測。

您也可以使用此端點來除錯驗證問題。如果請求失敗，請檢查您的 API 金鑰有效性和網路連線。回應將列出模型詳細資訊，包括上下文視窗大小和 token 限制。

Copyfrom openai import OpenAI

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

處理速率限制與錯誤

我們的 API 對每個金鑰實施每分鐘 300 個請求的限制。如果你超過此限制，將收到 429 錯誤。我們也支援 8 MB 的請求主體限制，適用於複雜的提示詞或大的上下文視窗。

常見錯誤包括 401（金鑰無效）和 402（額度不足）。預付額度永不過期，因此您可隨時儲值。額度贈品會自動套用於較大金額的購買：$50 以上贈送 +5%，$100 以上贈送 +10%。