KnoStar Router API 文档

欢迎使用 KnoStar Router —— 一站式 AI 模型统一接入平台。通过一个 API Key 即可调用 60+ 主流大模型。

快速开始

三步完成接入：

1. 注册账号并获取 API Key
2. 将 base_url 设置为 https://knostarrouter.com/v1
3. 使用任意 OpenAI 兼容 SDK 发起请求

Python 示例

from openai import OpenAI

client = OpenAI(
    base_url = "https://knostarrouter.com/v1",
    api_key  = "sk-your-api-key"
)

response = client.chat.completions.create(
    model    = "gpt-4o",
    messages = [
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

print(response.choices[0].message.content)

Node.js 示例

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://knostarrouter.com/v1',
  apiKey:  'sk-your-api-key',
});

const res = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }],
});

console.log(res.choices[0].message.content);

cURL 示例

curl https://knostarrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

注册与充值

注册账号

1. 访问 knostarrouter.com/register
2. 填写邮箱和密码完成注册
3. 登录后进入控制台

获取 API Key

1. 进入 控制台 → 令牌管理
2. 点击 新建令牌
3. 设置令牌名称和可用模型
4. 复制生成的 sk-xxx 密钥（只显示一次，请妥善保存）

充值

1. 进入 控制台 → 钱包管理
2. 选择充值金额和支付方式
3. 完成支付后余额即时到账

API 接入指南

接口地址

认证方式

所有请求需在 Header 中携带 API Key：

Authorization: Bearer sk-your-api-key

Chat Completions（对话补全）

POST /v1/chat/completions

请求参数

响应示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！我是 AI 助手..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 28,
    "total_tokens": 40
  }
}

模型列表

以下是平台已接入的主要模型，完整列表请访问 模型广场。

OpenAI

Anthropic Claude

其他模型

Claude Code 接入

本平台支持 Anthropic 原生协议，可直接用于 Claude Code。

配置方法

在终端设置环境变量：

# macOS / Linux
export ANTHROPIC_BASE_URL="https://knostarrouter.com"
export ANTHROPIC_API_KEY="sk-your-api-key"

# 启动 Claude Code
claude

或者写入配置文件 ~/.claude.json：

{
  "apiBaseUrl": "https://knostarrouter.com",
  "apiKey": "sk-your-api-key"
}

OpenAI Codex CLI 接入

配置方法

# 设置环境变量
export OPENAI_BASE_URL="https://knostarrouter.com/v1"
export OPENAI_API_KEY="sk-your-api-key"

# 启动 Codex
codex

流式传输

将 stream 参数设为 true 即可启用 SSE 流式传输，逐 Token 实时返回。

Python 流式示例

stream = client.chat.completions.create(
    model = "gpt-4o",
    messages = [{"role": "user", "content": "写一首诗"}],
    stream = True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

错误处理

计费说明

• 所有模型按 Token 用量 计费，输入和输出分开计价
• 实际价格 = 官方价格 × 倍率（默认 1.05x）
• 每次调用的消耗可在 控制台 → 使用日志 中查看
• 余额不足时请求将返回 401 错误

查询余额 API

curl https://knostarrouter.com/api/user/self \
  -H "Authorization: Bearer sk-your-api-key"

常见问题

和 OpenAI 官方 API 有什么区别？

接口格式完全一致，区别在于 base_url 指向本平台。本平台额外提供多模型聚合、人民币支付、国内直连等能力。

支持哪些客户端工具？

所有兼容 OpenAI API 的工具都可以使用，包括但不限于：Cherry Studio、ChatBox、Cline、Continue、Cursor、Dify、LangChain、OpenClaw 等。

延迟高怎么办？

• 优先选择距离近的模型（国产模型延迟更低）
• 开启流式输出减少首字等待时间
• 检查网络环境是否有代理干扰

支持图片/音频/视频模型吗？

支持。已接入 DALL·E、Midjourney、Suno 音乐、可灵视频等多模态模型，具体请查看模型广场。

令牌和 API Key 有什么区别？

令牌就是 API Key（sk-xxx 格式），两者是同一个东西。在本平台的控制台中统一叫做"令牌"。

联系我们