KToken Docs

Appearance

KToken 模型兼容层文档 ​

KToken 暴露了一组面向客户端和 SDK 的模型兼容接口，用于在统一鉴权、计费、分组和调度能力之上接入 Claude、OpenAI、Gemini 与 Antigravity 账户能力。

这份文档只覆盖“模型兼容层”接口，不包含站内业务接口、用户中心、支付或管理端 API。

你可以在这里找到什么 ​

  • Claude 兼容接口：/v1/messages、/v1/messages/count_tokens
  • OpenAI 兼容接口：/v1/responses、/v1/chat/completions、/v1/images/*
  • Gemini 原生兼容接口：/v1beta/models*
  • Antigravity 专用前缀：/antigravity/v1/*、/antigravity/v1beta/*
  • Codex 直连别名：/backend-api/codex/responses*
  • KToken 自身的认证、分流、限制、错误格式和别名规则

与官方协议的关系 ​

本站不是 OpenAI、Anthropic 或 Google Gemini 官方协议的完整替代文档。

本站采用以下策略：

  • 上游标准字段：只列常用核心字段，并提供官方规范链接
  • KToken 差异：重点说明路由别名、平台分流、认证方式、错误响应、支持限制、流式行为和本项目特有约束

基础地址 ​

通常部署后接口前缀为：

text
https://your-domain/api/v1

如果你的反向代理直接将根路径映射到后端，也可能直接暴露为：

text
https://your-domain

本文示例默认使用 https://your-domain/api/v1 作为反向代理挂载前缀。

由于后端模型兼容层本身还包含 /v1/... 或 /v1beta/... 路由，因此最终完整 URL 看起来可能是：

text
https://your-domain/api/v1/v1/messages
https://your-domain/api/v1/v1/responses
https://your-domain/api/v1/v1beta/models

这不是重复书写，而是“代理前缀 + 后端原始路由”叠加后的结果。

最短接入示例 ​

Claude SDK 风格 ​

bash
curl https://your-domain/api/v1/v1/messages \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 512,
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

OpenAI SDK 风格 ​

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": "hello" }
    ]
  }'

Gemini SDK 风格 ​

bash
curl "https://your-domain/api/v1/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "x-goog-api-key: sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [{ "text": "你好" }]
      }
    ]
  }'

协议选择建议 ​

  • Claude SDK / Claude Code：优先使用 /v1/messages
  • OpenAI SDK / 通用 OpenAI 客户端：优先使用 /v1/chat/completions 或 /v1/responses
  • Gemini SDK / Gemini CLI：使用 /v1beta/models/*
  • Codex 直连或特殊无前缀客户端：可使用 /backend-api/codex/responses* 或根路径别名

下一步 ​

Last updated: