API 文档

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

K-AI INT API

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

当前仅支持 Android

下载 APP

接口地址

POST /api/chat/completions/

K-AI INT api和部分第三方应用需使用完整API地址,多数软件只需要填写/api/根路径即可,自主开发必须填写完整地址,根据实际情况填写。

认证方式

所有请求必须携带 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

请求示例

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

返回示例

{
  "model": "你的模型名",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "你好！我是小K助手..."
      }
    }
  ]
}

格式二：自主 K_AI-api

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

请求参数

参数类型必填说明
modelstring必填模型名称
promptstring必填问题内容
chat_idstring可选对话标识，传了会记住上下文
自主格式不支持流式输出，始终一次性返回完整结果。

请求示例

{
  "model": "你的模型名",
  "prompt": "你好",
  "chat_id": "my_session_001"
}

返回示例

{
  "chat_id": "my_session_001",
  "model": "你的模型名",
  "reply": "你好！我是小K助手..."
}

连续对话

方式说明
用户自行维护标准格式下客户端自行维护 messages 数组，每次带上完整历史
服务端托管自主格式下传 chat_id，服务端自动存储上下文

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

错误码

状态码说明
400请求参数错误
401API 密钥无效
402余额不足
403对话标识无效
404对话已过期或不存在
405请求方法不允许
502服务内部错误
{
  "error": {
    "message": "401: Invalid API key",
    "code": 401
  }
}