KiroGate

OpenAI & Anthropic 兼容的 Kiro IDE API 代理网关

通过任何支持 OpenAI 或 Anthropic API 的工具使用 Claude 模型

功能特性 • 快速开始 • 配置说明 • API 参考 • 部署

---

致谢: 本项目基于 kiro-openai-gateway by @Jwadow 开发，整合 kiro-account-manager 全部功能。

---

✨ 功能特性

• 双 API 兼容 — 同时支持 OpenAI (/v1/chat/completions) 和 Anthropic (/v1/messages) 格式
• 完整流式传输 — SSE 流式响应，支持 Thinking 标签解析
• 工具调用 — 完整的 Function Calling / Tool Use 支持
• 多账号智能调度 — 账号池 + 健康分数 + 自动故障转移 + 配额追踪
• 多租户认证 — 简单 API Key / 组合模式 / 托管 API Key 三种认证方式
• 上下文压缩 — 三层缓存 + AI 摘要，自动压缩超长对话
• 熔断器 + 限流 — 令牌桶限流 + 熔断器模式保护后端
• 管理面板 — 内置 Web UI，账号管理、API Key 管理、Dashboard 监控
• 零外部依赖 — Deno 原生运行，内置 KV 存储，无需 Redis/数据库

📁 项目结构

kirogate/
├── main.ts              # 入口 + HTTP 路由 + 管理 API
├── lib/
│   ├── types.ts         # 类型定义
│   ├── kiroApi.ts       # Kiro API 客户端（双端点、DNS 缓存、机器码）
│   ├── accountPool.ts   # 多账号智能调度池
│   ├── translator.ts    # 格式转换（OpenAI ↔ Kiro ↔ Claude）
│   ├── stream.ts        # 流处理（AWS Event Stream + SSE）
│   ├── compressor.ts    # 上下文压缩（三层缓存 + AI 摘要）
│   ├── storage.ts       # Deno KV 存储层
│   ├── rateLimiter.ts   # 令牌桶限流
│   ├── errorHandler.ts  # 错误分类 + 熔断器
│   ├── logger.ts        # 日志系统
│   └── pages.ts         # 嵌入式 HTML 前端页面
├── deno.json            # Deno 配置
├── Dockerfile
└── docker-compose.yml

🚀 快速开始

环境要求

• Deno 2.x+

本地运行

# 设置环境变量
export PROXY_API_KEY="your-secret-api-key"
export ADMIN_PASSWORD="your-admin-password"

# 启动服务
deno run --allow-net --allow-env --unstable-kv main.ts

# 或使用 deno task
deno task start

# 开发模式（自动重载）
deno task dev

服务启动后访问 http://localhost:8000 查看首页。

添加账号

1. 访问 http://localhost:8000/admin/accounts
2. 输入管理密码（ADMIN_PASSWORD）
3. 点击「添加账号」，粘贴 Kiro 的 Refresh Token
4. 系统会自动刷新 Access Token

发送请求

# OpenAI 格式
curl http://localhost:8000/v1/chat/completions \
  -H "Authorization: Bearer your-secret-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

# Anthropic 格式
curl http://localhost:8000/v1/messages \
  -H "x-api-key: your-secret-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

⚙️ 配置说明

通过环境变量配置：

变量	默认值	说明
PROXY_API_KEY	changeme_proxy_secret	API 代理密钥
ADMIN_PASSWORD	admin	管理面板密码
PORT	8000	监听端口
LOG_LEVEL	INFO	日志级别（DEBUG/INFO/WARN/ERROR）
RATE_LIMIT_PER_MINUTE	0	全局限流（0=不限）
ENABLE_COMPRESSION	true	启用上下文压缩

🔑 认证方式

支持三种认证模式：

模式 1: 简单模式

使用 PROXY_API_KEY 直接认证，请求由服务端账号池分配账号：

Authorization: Bearer YOUR_PROXY_API_KEY

模式 2: 组合模式（多租户）

用户自带 Refresh Token，格式为 PROXY_API_KEY:REFRESH_TOKEN：

Authorization: Bearer YOUR_PROXY_API_KEY:YOUR_REFRESH_TOKEN

模式 3: 托管 API Key

通过管理面板创建的 kg- 前缀 Key，支持额度限制和模型限制：

Authorization: Bearer kg-xxxxxxxxxxxxxxxx

📡 API 参考

代理端点

方法	路径	说明
GET	/v1/models	获取可用模型列表
POST	/v1/chat/completions	OpenAI 聊天补全
POST	/v1/messages	Anthropic Messages API
GET	/health	健康检查

管理端点（需 Admin 密码）

方法	路径	说明
GET/POST	/api/accounts	账号列表 / 添加账号
PUT/DELETE	/api/accounts/:id	更新 / 删除账号
POST	/api/accounts/:id/refresh	手动刷新 Token
GET/POST	/api/keys	API Key 列表 / 创建 Key
PUT/DELETE	/api/keys/:id	更新 / 删除 Key
GET	/api/proxy/status	代理状态（无需认证）
GET	/api/proxy/health	健康报告（无需认证）
GET	/api/proxy/stats	详细统计
GET	/api/proxy/logs	请求日志
PUT	/api/proxy/config	更新运行时配置
GET/PUT	/api/settings	获取 / 更新设置

前端页面

路径	说明
/	首页
/docs	API 文档
/swagger	Swagger UI
/playground	在线测试
/deploy	部署指南
/dashboard	监控面板
/admin/accounts	账号管理
/admin/keys	API Key 管理

支持的模型

• claude-opus-4-5
• claude-sonnet-4-5
• claude-sonnet-4
• claude-haiku-4-5
• claude-3-7-sonnet-20250219

💻 SDK 使用示例

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8000/v1",
    api_key="your-secret-api-key"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True
)

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

Python (Anthropic SDK)

import anthropic

client = anthropic.Anthropic(
    base_url="http://localhost:8000",
    api_key="your-secret-api-key"
)

message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)

Node.js (OpenAI SDK)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "http://localhost:8000/v1",
  apiKey: "your-secret-api-key",
});

const stream = await client.chat.completions.create({
  model: "claude-sonnet-4-5",
  messages: [{ role: "user", content: "Hello!" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

🐳 部署

Docker

FROM denoland/deno:latest
WORKDIR /app
COPY . .
EXPOSE 8000
CMD ["run", "--allow-net", "--allow-env", "--unstable-kv", "main.ts"]

docker build -t kirogate .
docker run -d -p 8000:8000 \
  -e PROXY_API_KEY="your-key" \
  -e ADMIN_PASSWORD="admin123" \
  kirogate

Docker Compose

version: "3"
services:
  kirogate:
    build: .
    ports:
      - "8000:8000"
    environment:
      - PROXY_API_KEY=your-key
      - ADMIN_PASSWORD=admin123
    restart: unless-stopped

Deno Deploy

deno install -A jsr:@deno/deployctl
deployctl deploy --project=your-project main.ts

🏗️ 架构说明

多账号调度

账号池支持三种调度模式：

• Smart（默认）— 基于健康分数 + 并发感知的智能调度
• Priority — 按优先级顺序使用
• Balanced — 均匀分配请求

每个账号维护 0-100 的健康分数，基于成功率、错误率和冷却状态动态调整。全部账号不可用时自动触发自愈机制。

上下文压缩

当对话超过 token 阈值时自动触发：

1. 保留最近 N 条消息不压缩
2. 历史消息分批发送给 Claude Haiku 生成摘要
3. 三层缓存加速：增量内存 → LRU 内存 → Deno KV 持久化

熔断器

采用 CLOSED → OPEN → HALF_OPEN 三态模型，连续失败达到阈值后自动熔断，保护后端服务。

📄 许可证

AGPL-3.0