Mukenetsu AI API 快速入門

基本設定與 Base URL

Mukenetsu AI 設計為相容 OpenAI 的 REST API。這使得只需少量修改即可使用現有的 OpenAI 客戶端或 SDK。與 API 通訊請使用以下 Base URL。

https://api.mukenetsuapi.com/v1

與其他 LLM 服務不同，無需複雜的端點選擇或額外設定。僅提供單一聊天補全端點和模型列表端點。這種簡化的結構讓開發能迅速進行。

API 金鑰可在Get API key頁面使用電子郵件和密碼註冊時，於註冊後立即取得。無需操作儀表板。此外，我們重視隱私，提示詞資料不會用於模型訓練。

認證與 API 金鑰

存取 API 需要透過標頭Authorization: Bearer <API_KEY>進行認證。Mukenetsu AI 的 API 金鑰使用建立帳戶時生成的金鑰。一個帳戶分配一個 API 金鑰，但您可以隨時重新生成。重新生成金鑰後，舊金鑰將失效，請注意。

若發生認證錯誤，通常會返回 401（Unauthorized）或 402（Payment Required）回應。401 表示金鑰錯誤或已失效，402 表示帳戶的額度餘額不足。額度為預付式，可透過加密貨幣（USDT・USDC）以 $10 以上進行儲值。

聊天補全端點

文本生成的主要端點為POST /v1/chat/completions。透過向此端點發送請求，您可以生成包含對話歷史或系統提示詞的文本。請指定模型 ID 為uncensored。這是與 OpenAI 的 GPT 或其他供應商模型不同的自有開放權重模型。

以下範例顯示如何使用 curl 進行基本的文本生成。必要的參數為模型 ID、訊息，以及可選的串流啟用選項。

コピーcurl https://api.mukenetsuapi.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."}]
  }'

此端點不提供嵌入（embeddings）、圖像生成或語音轉換等功能。它專門用於純文本的補全與生成。

串流（SSE）

若希望即時取得生成的文本，可使用串流模式。在請求中包含"stream": true，伺服器將以伺服器發送事件（SSE）格式逐步返回數據。這讓用戶可以在生成完成前顯示部分文本。

若使用 Python 的 OpenAI SDK 或 Node.js 的客戶端庫，只需指定stream=True選項即可自動進行串流處理。事件處理器將接收每個 token 的區塊。

コピーfrom openai import OpenAI

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

串流是提升長回應或互動式應用程式使用者體驗的重要功能。然而，若串流期間連線中斷，將無法接收後續事件。

工具/函式呼叫

Mukenetsu AI API 支援工具（函式）呼叫。這使得與外部 API 或資料庫的整合變得更容易。在請求主體中包含tools欄位和tool_choice參數，即可讓模型執行特定函式。

模型會根據需要判斷是否呼叫函式或返回一般文本。呼叫完成後，將函式結果新增至messages並傳遞給模型，即可獲得更詳細的回答。

コピーimport OpenAI from "openai";

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

此功能對代理型應用程式或複雜任務自動化特別有用。由於採用 OpenAI 相容格式，您可以直接沿用現有的工具呼叫邏輯。

速率限制與限制

API 使用有以下限制：每分鐘最多 300 個請求，請求主體最大尺寸為 8 MB。超過這些限制將返回 429（Too Many Requests）錯誤。上下文視窗為 100,000 token（提示詞＋生成文本總和）。對於超過此限制的長對話或文件，需適當分割後發送。

接收串流回應時，請遵循以下事件流程。

コピーstream = 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)

此外，與未成年人的性內容受到嚴格限制。這是為了符合法律營運。其他合法的成人內容、虛構作品、安全研究或爭議性主題則無審查地生成。