Mukenetsu AI API 快速入门

基本配置与 Base URL

Mukenetsu AI 设计为兼容 OpenAI 的 REST API。这使得只需少量修改即可使用现有的 OpenAI 客户端或 SDK。与 API 通信请使用以下 Base URL。

https://api.mukenetsuapi.com/v1

与其他 LLM 服务不同，无需选择复杂的接口或进行额外配置。仅提供一个聊天补全接口和一个模型列表接口。这种简单的结构使开发能够快速进行。

API 密钥可在获取 API 密钥页面使用电子邮件和密码注册时立即获得。无需仪表盘操作。此外，我们重视隐私，提示词数据不用于模型训练。

认证与 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。这是不同于 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)

此外，与未成年人的性内容受到严格限制，这是为了符合法律规定。其他合法的成人内容、虚构作品、安全研究和争议性主题则无审查地生成。