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、/images/edits、/gpt/images/: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://api.nvue.dev

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

text
https://api.nvue.dev/v1/messages
https://api.nvue.dev/v1/responses
https://api.nvue.dev/v1beta/models
https://api.nvue.dev/images/generations
https://api.nvue.dev/gpt/images/:task_id

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

最短接入示例 ​

Claude SDK 风格 ​

bash
curl https://api.nvue.dev/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://api.nvue.dev/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://api.nvue.dev/images/generations \
  -H "Authorization: Bearer sk-xxxx" \
  -H "X-KToken-Async: true" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴眼镜的橘猫坐在书桌前"
  }'

图片编辑也可以使用同样的方式：请求 /images/edits 时传入 X-KToken-Async: true，或在 JSON 请求体中传入 "async": true。

提交成功后使用返回的 task_id 轮询：

bash
curl https://api.nvue.dev/gpt/images/<task_id> \
  -H "Authorization: Bearer sk-xxxx"

Gemini SDK 风格 ​

bash
curl "https://api.nvue.dev/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 或 /images/edits，轮询时使用 /gpt/images/:task_id
  • Gemini SDK / Gemini CLI：使用 /v1beta/models/*
  • Codex：参考 Codex 配置

下一步 ​

Last updated: