API 文件

快速上手：您的第一個請求

立即向無審查模型發送第一條訊息。使用標準的 chat-completions 端點生成文本。該模型會以自然語言提示進行回應，對於合法成人用途不會有內容審查。此設定適用於任何 OpenAI 相容的客戶端。

安裝您偏好語言的 SDK。然後設定您的 API 金鑰。以下範例顯示用於測試連線性的基本 curl 請求。

您可以調整如 temperature 等參數以控制隨機性。回應會直接返回生成的文本。這種簡單的流程讓您在建構複雜邏輯之前，即可驗證 API 是否正常運作。

Copycurl https://api.apiaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit status?"}]
  }'

基礎 URL 與驗證

使用此 API 的專用基礎 URL 進行連接。將默認端點替換為我們的託管伺服器地址。這確保您的請求直接到達無限制模型。身份驗證依賴於每個帳戶的單一 API 金鑰。

透過儀表板產生您的金鑰。將其作為 Bearer token 傳遞至 Authorization 標頭。此方法與標準 OpenAI SDK 相容。您可以僅透過變更基礎 URL 和金鑰來切換供應商。

保持您的金鑰安全。它授予您預付信用額度的完整存取權。生成新金鑰後，該金鑰會立即取代任何先前的有效金鑰。

端點：聊天完成

透過聊天完成端點與模型互動。這是唯一的文字生成端點。它接受訊息並返回生成的文字。不支援嵌入、影像或音訊。

向聊天路由發送 POST 請求。在載入中包含您的系統和使用者訊息。模型處理上下文並生成回應。您可以使用 JSON 模式進行結構化輸出。

也支援函式呼叫。定義工具並讓模型決定何時使用它們。這種靈活性允許複雜的代理工作流程。回應包含生成的內容與 token 使用量。

Copyfrom openai import OpenAI

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

參數：Temperature、Top P 和 Stop

使用標準參數控制輸出風格。調整 temperature 以改變創造力。較低的值會使回應更具決定性。較高的值則會引入更多樣性。

使用 top P 過濾可能性較低的詞彙。這有助於在保持連貫性的同時允許創意發揮。設定 stop 序列以在特定標記處結束生成。這對於控制對話結構很有用。

種子（seed）參數可產生可重現的結果。在偵錯提示詞時請使用它。這些參數讓您可以精確控制模型的行為。微調它們以符合您應用程式的需求。

Copyimport OpenAI from "openai";

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

串流與 token 使用量

透過伺服器發送事件即時接收回應。串流能降低使用者的感知延遲。API 會即時傳送已產生的權杖，從而提供更流暢的閱讀體驗。

Token 用量報告在最後一個區塊中。這使您能夠準確追蹤成本。計費基於實際消耗的 Token。錯誤和拒絕不會產生費用。

實作串流處理器來處理資料。隨著 token 到達更新您的 UI。這種方法非常適合聊天介面。模型支援所有請求類型的串流。

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)

速率限制與限制條件

了解限制以避免服務中斷。每支金鑰每分鐘可發出 300 次請求。同時併發請求上限為八個。請求主體不得超過 8 MB。

優雅地處理錯誤。401 狀態表示您的無效。402 狀態表示信用額度不足。429 狀態表示您已達到速率限制。

上下文視窗總共支援 100,000 個 token。這包含提示詞與補全內容。每次請求的最大輸出為 16,000 個 token。設定 max_tokens 以控制輸出長度。錯誤請求免費，因此重試邏輯是安全的。