Hermes api 文件：快速入門

安裝與設定

Hermes API 適用於任何支持 OpenAI 格式的客戶端。您需要基礎 URL 和 API 密鑰。通過 Google 或電子郵件在獲取 API 密鑰頁面創建帳戶。系統會立即顯示您的密鑰。不需要電話號碼。您將獲得 $0.50 的七天試用信用額度。之後僅通過加密貨幣充值。

• 基礎 URL：HTTPS://api.apihermes.cc/v1
• Auth header: Authorization: Bearer YOUR_API_KEY
• 模型 ID：uncensored

安裝您偏好的 SDK 並設定基礎 URL。該端點期望標準的聊天完成參數。妥善保管您的金鑰。如果您產生新的金鑰，舊金鑰將被取代。

基本聊天完成請求

基本請求發送訊息並接收文本回應。模型 ID 為 uncensored（無審查）。它處理合法的成人內容而不會拒絕。您按使用的 token 付費。錯誤和拒絕不計費。上下文視窗總共可容納 100,000 個 token。

使用 system 消息和 user 消息構造您的請求。API 返回補全。您可以設置 max_tokens 來控制輸出長度。默認輸出限制為 2,048 令牌。您可以將每次請求的此限制提高到 16,000 令牌。流式傳輸通過 SSE 工作。函數調用可用。支持 JSON 模式。

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

請求主體限制為 8 MB。速率限制為每分鐘 300 次請求。並發限制為同時 8 個請求。重試邏輯可優雅地處理服務器過載。

帶有 SSE 的串流回應

串流在您產生 Token 時即傳送 Token。伺服器會發送伺服器發送事件（SSE）。每個區塊包含部分文字。最後一個區塊包含 Token 用量統計資料。這種方法可降低長回應的感知延遲。它非常適合聊天介面。您必須正確處理串流。可能會發生斷線。API 不保證串流本身之外的傳送順序。

將 stream 參數設為 true。解析資料行。串連內容。檢查 finish_reason 以確認完成。uncensored 模型可與任何 OpenAI 相容的 SDK 搭配使用。設定客戶端以處理 SSE。監控 token 計數。基礎 URL 保持不變。驗證方式相同。無需額外設定。

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 扣除。這在中斷期間節省費用。您從未為部分垃圾輸出付費。系統是透明的。

使用函數調用和工具

函式呼叫允許模型執行程式碼或工具。在請求主體中定義工具。模型回傳工具呼叫。您執行該工具。您將結果回傳。模型生成最終回應。這能實現複雜的工作流程。它不僅僅是聊天包裝函式。API 支援工具和 tool_choice。將其用於代理或自動化。

構造 tools 數組。包含名稱、描述和參數。模型決定何時調用工具。您必須解析參數。執行函數。將輸出傳遞給對話。模型繼續。這個循環重複直到最終答案。上下文窗口跟踪所有工具交互。跟踪令牌使用情況。工具輸出會增加成本。在最後一個 chunk 中監控使用情況。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apihermes.cc/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 可靠。無錯誤。預付系統確保公平。您掌控流程。基礎 URL 一致。驗證簡單。

JSON 模式與參數

JSON 模式強制模型輸出有效的 JSON。將 response_format 設為 json_object。這對於結構化資料很有用。模型避免 Markdown 封裝。它返回原始 JSON。使用此模式進行解析。它提高可靠性。上下文視窗仍然適用。您為 token 付費。Uncensored 模型尊重格式。它不會基於內容拒絕。

參數包括 temperature（溫度）、top_p、stop、seed、presence_penalty 和 frequency_penalty。Temperature 控制隨機性。Top_p 控制多樣性。停止序列終止生成。Seed 確保可重現性。存在和頻率懲罰調整 token 使用。設定這些參數以優化輸出。API 支援所有標準參數。使用它們來調整回應。基礎 URL 保持不變。身份驗證方式相同。

Copyimport OpenAI from "openai";

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

錯誤透過 HTTP 狀態碼處理。401 表示金鑰無效。402 表示信用額度不足。429 表示達到速率限制。請在程式碼中處理這些情況。預付信用額度僅針對完成的 token 扣款。這確保了公平性。您無需為部分輸出付費。系統透明。uncensored 模型可靠。可用於任何合法任務。

錯誤處理與速率限制

API 回傳標準 HTTP 狀態碼。401 表示 API 金鑰無效。402 表示預付額度不足。429 表示達到速率限制。限制為每分鐘 300 個請求。並發請求為八個。請求主體限制為 8 MB。優雅地處理這些錯誤。使用指數退避重試。無限制模型不會拒絕合法內容。錯誤是免費的。您無需為失敗的請求付費。預付額度是安全的，且永不過期。如有重複扣款，請使用支援頁面。僅接受加密貨幣。USDT 或 USDC。適用獎勵。