KToken Docs

Appearance

KToken API 文档 ​

KToken 提供一组兼容主流模型服务的 API。你可以用同一个 API Key，在支持的客户端、SDK 或命令行工具中接入 Claude、OpenAI、Gemini 与 Antigravity。

本文介绍常用模型 API 的调用方式，适合在客户端、SDK 或命令行工具中直接接入。

你可以在这里找到什么 ​

  • Claude 调用方式：/v1/messages、/v1/messages/count_tokens
  • OpenAI 调用方式：/v1/responses、/v1/chat/completions、/v1/images/*
  • OpenAI 图片异步任务：/images/generations/async、/images/edits/async、/images/tasks/:task_id
  • Gemini 调用方式：/v1beta/models*
  • Antigravity 专用入口：/antigravity/v1/*、/antigravity/v1beta/*
  • Codex 配置入口：/backend-api/codex/responses*
  • API Key 认证、可用接口、错误响应和常见限制

与官方 API 的关系 ​

KToken 尽量保持与 OpenAI、Anthropic 和 Google Gemini 的官方 API 兼容。你可以参考官方文档了解完整字段；本站重点说明接入 KToken 时需要注意的地址、认证、路由别名、异步任务和使用限制。

基础地址 ​

文档示例默认使用以下基础地址：

text
https://example.com

调用时直接在基础地址后追加接口路径：

text
https://example.com/v1/messages
https://example.com/v1/responses
https://example.com/v1beta/models
https://example.com/images/generations
https://example.com/images/tasks/:task_id

请不要在这些地址中额外添加其他前缀。

最短接入示例 ​

Claude SDK 风格 ​

bash
curl https://example.com/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://example.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "hello" }
    ]
  }'

OpenAI 图片异步任务 ​

bash
curl https://example.com/images/generations/async \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴眼镜的橘猫坐在书桌前"
  }'

图片编辑使用 /images/edits/async。同步和异步由请求路径决定，不需要额外的异步请求头或请求体字段。

提交成功返回 HTTP 202 后，使用返回的 task_id 轮询，并检查 status 判断任务是否成功：

bash
curl https://example.com/images/tasks/<task_id> \
  -H "Authorization: Bearer sk-xxxx"

Gemini SDK 风格 ​

bash
curl "https://example.com/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
  • OpenAI 图片生成：可使用 /v1/images/generations，也可使用 /images/generations
  • OpenAI 图片编辑：可使用 /v1/images/edits，也可使用 /images/edits
  • OpenAI 图片异步任务：提交时使用 /images/generations/async 或 /images/edits/async，轮询时使用 /images/tasks/:task_id
  • Gemini SDK / Gemini CLI：使用 /v1beta/models/*
  • Codex：参考 Codex 配置

下一步 ​

Last updated: