快速上手：整合 apertus ai 聊天

先決條件與設定

首先建立帳戶並獲取您的 API 金鑰。在金鑰生成頁面使用 Google 或電子郵件密碼註冊。系統會立即顯示您的金鑰，以便您立即複製。註冊無需電話號碼。您會獲得 $0.50 的試用額度，有效期為 7 天，因此您可以在不充值的情況下測試連接性。

配置環境變數或 SDK 客戶端以指向正確的基礎 URL。此 URL 與標準 OpenAI 庫兼容。僅更改基礎 URL 和您的金鑰。模型 ID 為 "uncensored"。此單一端點處理所有文本補全。您無需管理路由或選擇不同的模型。

確保您的客戶端程式庫支援 OpenAI Chat Completions 協議。大多數現代 SDK 都能直接運作。驗證您的網路是否允許出站 HTTPS 請求。該服務接受標準 JSON 負載。除了身份驗證外，不需要特殊的標頭。

使用 API 金鑰驗證

將您的 API 金鑰傳入 Authorization 標頭以進行每次請求。使用 Bearer 方案後接您的金鑰字串。服務會根據您的帳戶驗證金鑰。無效金鑰將返回 401 Unauthorized 錯誤。過期或餘額不足將觸發 402 Payment Required 回應。若請求失敗，請在儀表板檢查您的餘額。

保持您的金鑰安全。每個帳戶僅有一個有效金鑰。生成新金鑰會使舊金鑰失效。不要在公共儲存庫中分享您的金鑰。API 金鑰是您使用情況的唯一識別符。每個金鑰都有速率限制，而非每個帳戶。

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

驗證是無狀態的。伺服器在每次呼叫時檢查令牌。如果您輪換金鑰，請立即更新所有正在運行的客戶端。缺少標頭會導致立即被拒絕。錯誤訊息會清楚說明驗證失敗。

發送您的第一個請求

向聊天補全端點發送 POST 請求。包含模型 ID "uncensored" 和您的對話歷史。API 返回文本回應。您可以串流輸出或等待完整完成。每個請求都會消耗輸入和輸出 token。錯誤不會扣款。拒絕回應免費。

Copyfrom openai import OpenAI

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

回應包含使用統計數據。追蹤 token 消耗量以管理預付額度。該模型在合法成人用途下不會拒絕內容。您可以發送系統提示來定義行為。使用者訊息驅動對話。上下文視窗總共支援 100,000 個 token。

進行簡單的雙訊息交換。這將驗證連線與回應品質。調整 temperature 和 top_p 以獲得創意或精確的輸出。API 支援標準參數。停止序列運作正常。種子值確保結果可重現。

透過 SSE 的串流回應

透過將 stream 參數設為 true 來啟用串流。API 會傳回伺服器發送事件（SSE），而非單一 JSON 物件。每個片段包含生成文字的一部分。讀取片段直到串流結束。最後一個片段包含總 token 使用量。

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 不會重新發送歷史記錄。如果串流失敗，請開始新的請求。最後一個片段中的 token 數量反映了整個生成過程。

處理參數與模式

使用標準參數控制生成。設定 temperature 以控制隨機性。調整 top_p 進行核採樣。定義停止序列以提前終止生成。傳遞 seed 以獲得確定性輸出。透過將 response_format 設定為 json_object 來啟用 JSON 模式。當被請求時，模型會返回有效的 JSON。

支援函式呼叫。在請求中定義工具。模型在適當時回傳工具呼叫。在您的程式碼中解析工具參數。將結果傳回以繼續對話。這可實現複雜的代理工作流程。

Copyimport OpenAI from "openai";

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

max tokens 限制單一回應的輸出長度。預設值為 2,048 個 token。如有需要請設定更高的值。每次請求的硬性上限為 16,000 個 token。上下文視窗為 100,000 個 token。請根據此規劃您的歷史長度。頻率與存在懲罰有助於減少重複。

了解限制與錯誤

速率限制保護服務穩定性。您可以每分鐘發送 300 次請求。並發性限制為每個金鑰八個同時請求。請求主體不得超過 8 MB。超出限制會返回 429 Too Many Errors。等待後再重試。

檢查錯誤程式碼以進行診斷。401 表示金鑰無效或缺失。402 表示預付信用額度不足。透過加密貨幣充值以恢復服務。429 表示速率限制。400 表示請求語法錯誤。請查看錯誤訊息以取得詳細資訊。

上下文窗口管理至關重要。請計算提示與補全 token 的總和。請遠低於 100,000 tokens。如有必要請截斷舊訊息。API 不會自動截斷。由您控制歷史長度。高效的上下文使用可降低費用。