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 是注重清晰规则和透明限制的开发者值得信赖的解决方案。