KToken Docs

Appearance

POST /v1/chat/completions ​

接口用途 ​

OpenAI Chat Completions 兼容接口。

这条路由同样会按当前 API Key 的分组平台自动分流：

  • OpenAI 分组：进入 OpenAI Chat Completions 实现
  • 非 OpenAI 分组：进入 Anthropic 兼容的 Chat Completions 转换链

请求路径 ​

text
POST /v1/chat/completions

认证方式 ​

  • Authorization: Bearer <API_KEY>
  • x-api-key: <API_KEY>

路由别名 ​

  • POST /chat/completions

适用平台 ​

  • OpenAI 分组
  • Anthropic / Claude 分组
  • Antigravity 间接支持对应分流路径，但专用前缀仍更清晰

上游官方规范 ​

本项目支持说明 ​

  • 自动按分组平台分流
  • 支持流式与非流式
  • 支持模型映射和故障切换
  • 对 Anthropic 分组，会做 Chat Completions 到 Anthropic 链路的转换

参数说明 ​

常用上游标准字段 ​

参数类型必填说明
modelstring是目标模型
messagesarray是标准 OpenAI 对话消息
streamboolean否是否开启流式
toolsarray否工具定义
temperaturenumber否采样参数

完整字段请参考 OpenAI 官方规范。

KToken 差异与限制 ​

字段 / 行为说明
model缺失会返回 400
空请求体 / 非法 JSON直接返回 400
分组为 ClaudeCodeOnly代码会拒绝此接口，并提示该分组只允许 /v1/messages
stream会参与并发和上游转发策略

响应说明 ​

成功时返回标准 Chat Completions 响应，流式时返回 SSE。

示例响应 ​

json
{
  "id": "chatcmpl_123",
  "object": "chat.completion",
  "model": "gpt-4.1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好"
      },
      "finish_reason": "stop"
    }
  ]
}

错误响应 ​

ClaudeCodeOnly 分组 ​

json
{
  "error": {
    "type": "permission_error",
    "message": "This group is restricted to Claude Code clients (/v1/messages only)"
  }
}

示例请求 ​

bash
curl https://your-domain/api/v1/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "messages": [
      { "role": "user", "content": "给我一句简短问候" }
    ]
  }'

注意事项 ​

  • 如果你的客户端原生支持 Anthropic，Claude 分组更推荐直接走 /v1/messages
  • 这个接口更适合 OpenAI SDK 兼容接入