API 文档

小K助手接口说明，支持标准 OpenAI 格式与自主 K_AI-api 格式两种调用方式。

K-AI INT API

下载客户端 APP，无需编写代码即可连接 AI API

当前仅支持 Android

下载 APP

接口地址

POST /api/chat/completions/

认证方式

所有请求必须携带 api_key，可通过以下任一方式传递：

方式说明
HTTP HeaderAuthorization: Bearer YOUR_API_KEY
POST Body{"api_key": "YOUR_API_KEY", ...}
GET 参数?api_key=YOUR_API_KEY

格式一：标准 OpenAI

兼容 OpenAI Chat Completions 格式，可直接使用任意支持 OpenAI 的客户端接入。

请求参数

参数类型必填说明
modelstring必填模型名称，由平台提供
messagesarray必填对话消息数组，由客户端自行维护
streambool可选是否流式输出，默认 false
标准格式下，对话历史由客户端自行维护。每次请求需将完整的 messages 数组发送至服务端。

请求示例

curl 本站域名/api/chat/completions/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "xiao-k_A1",
  "messages": [
    { "role": "user", "content": "你好" }
  ],
  "stream": false
}'

返回示例（非流式）

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "xiao-k_A1",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "你好！我是小K助手..."
      }
    }
  ]
}

返回示例（流式 SSE）

data: {"choices":[{"delta":{"content":"你好"}}]}
data: {"choices":[{"delta":{"content":"！"}}]}
data: [DONE]

格式二：自主 K_AI-api

小K助手自有格式，更简洁，适合快速集成。

请求参数

参数类型必填说明
modelstring必填模型名称
promptstring / array必填问题内容，可传字符串或消息数组
chat_idstring可选对话标识。不传则由客户端自行维护历史；传了则由服务端托管上下文
自主格式不支持流式输出，始终一次性返回完整结果。
客户端可自行维护历史（不传 chat_id），每次将完整 messages 通过 prompt 数组发送；也可传 chat_id 交由服务端托管。

请求示例（客户端自行维护历史）

{
  "model": "xiao-k_A1",
  "prompt": [
    { "role": "user", "content": "你好" },
    { "role": "assistant", "content": "你好！" },
    { "role": "user", "content": "刚才说了什么" }
  ]
}

请求示例（服务端托管历史）

{
  "model": "xiao-k_A1",
  "prompt": "你好",
  "chat_id": "my_session_001"
}

返回示例

{
  "model": "xiao-k_A1",
  "reply": "你好！我是小K助手..."
}

连续对话

方式说明
标准 OpenAI 格式客户端必须自行维护 messages 数组，每次带上完整历史
自主格式 - 客户端维护不传 chat_id，通过 prompt 数组发送完整历史
自主格式 - 服务端托管传 chat_id，服务端自动存储上下文

服务端托管时，历史消息保留最近 40 条，最后一条消息超过 30 天 无活动自动清除。

错误码

状态码说明
400请求参数错误
401API 密钥无效
402余额不足
403对话标识无效
404对话已过期或不存在
405请求方法不允许
500服务器初始化失败
502服务内部错误

错误返回示例（非流式）

{
  "error": {
    "message": "401:Invalid API key",
    "code": 401
  }
}

错误返回示例（流式）

data: {"choices":[{"delta":{"content":"401:Invalid API key"}}]}
data: [DONE]