KiApi 文件：5 分鐘內完成整合

入門：基礎 URL 與身份驗證

KiApi 完全符合 OpenAI API 規範。您可以透過調整 base_url 來使用現有的 SDK 與用戶端生態系統。所有請求的基礎 URL 為 https://api.kiapis.com/v1。驗證僅限於 API 金鑰，該金鑰會在您註冊後於儀表板頁面取得。此金鑰必須透過 HTTP 標頭 Authorization: Bearer <IHR_API_SCHLÜSSEL> 傳送。你可以隨時產生新的金鑰，舊金鑰隨即失效。

與其他服務不同，我們不提供複雜的嵌入或微調端點。我們專注於純文字生成。KiApi 是您連接到針對無審查回應進行優化的模型的直接管道。請在發送第一個請求前確保正確設定環境。

POST /v1/chat/completions：文字生成

API 的核心是端點 POST /v1/chat/completions。在此傳送訊息列表（系統、使用者、助手）並取得文字回應。模型 ID 參數必須設為 uncensored。回應是同步的，立即包含生成的文字片段及 token 使用元數據。

請求結構遵循標準格式。您可以定義角色以清晰組織上下文。系統處理輸入並根據模型的學習行為生成回應。這是幾乎所有文字應用的主要方法，從聊天機器人到文字分析皆適用。

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

回應包含一個 JSON 物件，內含生成的內容。請務必從回應中提取 content 區塊以供應用程式後續使用。標準回應不會返回每請求額外元數據（如成本），請至儀表板查看。

透過伺服器發送事件 (SSE) 進行串流輸出

對於需要即時輸出的應用程式，KiApi 支援透過伺服器發送事件（SSE）進行串流輸出。只需在請求主體中設定 "stream": true 即可啟用。你無需等待完整回應，即可取得包含逐步生成文字的 JSON 修補程式資料流。

這對於聊天介面特別有用，即時回饋能提升使用者體驗。KiApi 作為串流 API 能降低延遲並產生即時對話的感覺。客戶端必須解析資料流並將片段拼接，直到串流結束信號為止。

Kopierenstream = 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 使用統計數據通常在串流結束的最後一個事件中返回。這允許根據實際生成長度進行精確計費。請確保您的客戶端程式碼處理串流結束，以正確釋放資源。

工具呼叫與函式呼叫

該模型支援工具呼叫（亦稱函式呼叫）。這允許 LLM 返回結構化的 JSON 資料，代表應用程式中的特定功能或動作。您在請求主體中定義可用工具，模型根據使用者輸入決定何時呼叫工具。

工具定義的結構遵循 OpenAI 標準。您可以指定多個工具，模型會選擇最合適的一個。回應包含工具呼叫列表，您可在後端邏輯中執行這些呼叫。這將 KiApi 的功能大幅擴展至純文字生成之外。

Kopierenfrom openai import OpenAI

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

利用工具呼叫自動化複雜工作流程。模型直接在 JSON 格式中提供工具的參數。您無需使用外部解析器處理回應，因為結構直接來自模型。這使得整合至現有系統變得更加簡單可靠。

GET /v1/models：可用模型

端點 GET /v1/models 列出可透過 API 存取的可用模型。這有助於動態檢查哪些模型可用或確認模型 ID。通常您會收到包含模型 uncensored 的列表。

回應包含模型的元數據，如 ID、擁有者和建立日期。與其他一些 API 不同，標準回應不直接包含最大上下文長度或特定價格。這些資訊需從文件或儀表板取得。然而，此端點對於客戶端自動設定不可或缺。

Kopierenimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kiapis.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 金鑰允許每分鐘 300 個請求。最大請求主體為 8 MB。若超過這些限制，將收到 HTTP 狀態碼 429 Too Many Requests。請規劃您的應用程式以實現指數退避的重試機制。

其他常見錯誤代碼包括 401 Unauthorized（API 金鑰無效時）和 402 Payment Required（額度耗盡時）。KiApi 採用預付額度模式，因此若無額度，請求將立即被拒絕。請確保定期檢查帳戶餘額。

上下文視窗為輸入與輸出合計 100,000 token。若超過此限制，將返回錯誤訊息。KiApi 是可靠的解決方案，適合欣賞明確規則與透明限制的開發者。