huangzhenpc/kirogo

Fork 0

Files

Quorinex 2bdc2a9936 docs: improve disclaimer

2026-02-04 00:41:27 +08:00

4.9 KiB

Raw Blame History

Kiro API Proxy

将 Kiro 账号转换为 OpenAI / Anthropic 兼容的 API 服务。

English | 中文

功能特性

🔄 Anthropic Claude API - 完整支持 /v1/messages 端点
🤖 OpenAI Chat API - 兼容 /v1/chat/completions
⚖️ 多账号池 - 轮询负载均衡
🔐 自动刷新 Token - 无缝 Token 管理
📡 流式响应 - 实时 SSE 输出
🎛️ Web 管理面板 - 便捷的账号管理
🔑 多种认证方式 - IAM SSO、SSO Token、凭证导入
📊 用量追踪 - 监控请求数、Token、Credits

快速开始

Docker Compose（推荐）

git clone https://github.com/Quorinex/kiro-api-proxy.git
cd kiro-api-proxy

# 创建数据目录用于持久化
mkdir -p data

docker-compose up -d

Docker 运行

# 创建数据目录
mkdir -p /path/to/data

docker run -d \
  --name kiro-api-proxy \
  -p 8080:8080 \
  -e ADMIN_PASSWORD=your_secure_password \
  -v /path/to/data:/app/data \
  --restart unless-stopped \
  ghcr.io/quorinex/kiro-api-proxy:latest

📁 /app/data 卷存储 config.json（包含账号和设置），挂载此目录以实现数据持久化。

源码编译

git clone https://github.com/Quorinex/kiro-api-proxy.git
cd kiro-api-proxy
go build -o kiro-api-proxy .
./kiro-api-proxy

配置

首次运行会自动创建 data/config.json：

{
  "password": "changeme",
  "port": 8080,
  "host": "127.0.0.1",
  "requireApiKey": false,
  "apiKey": "",
  "accounts": []
}

⚠️ 生产环境请务必修改默认密码！

环境变量

变量	说明	默认值
`CONFIG_PATH`	配置文件路径	`data/config.json`
`ADMIN_PASSWORD`	管理面板密码（覆盖配置文件）	-

使用方法

1. 访问管理面板

打开 http://localhost:8080/admin，输入密码登录。

2. 添加账号

支持三种方式：

方式	说明
IAM SSO	企业用户，输入 SSO Start URL
SSO Token	从浏览器导入 `x-amz-sso_authn`
凭证导入	从 Kiro Account Manager 导入 JSON

凭证格式

{
  "refreshToken": "eyJ...",
  "accessToken": "eyJ...",
  "clientId": "xxx",
  "clientSecret": "xxx"
}

3. 调用 API

Claude API

curl http://localhost:8080/v1/messages \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好！"}]
  }'

OpenAI API

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer any" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

模型映射

请求模型	实际模型
`claude-sonnet-4-20250514`	claude-sonnet-4-20250514
`claude-sonnet-4.5`	claude-sonnet-4.5
`claude-haiku-4.5`	claude-haiku-4.5
`claude-opus-4.5`	claude-opus-4.5
`gpt-4o`, `gpt-4`	claude-sonnet-4-20250514
`gpt-3.5-turbo`	claude-sonnet-4-20250514

API 端点

端点	说明
`GET /health`	健康检查
`GET /v1/models`	模型列表
`POST /v1/messages`	Claude Messages API
`POST /v1/messages/count_tokens`	Token 计数
`POST /v1/chat/completions`	OpenAI Chat API
`GET /admin`	管理面板

项目结构

kiro-api-proxy/
├── main.go              # 入口
├── config/              # 配置管理
├── pool/                # 账号池 & 负载均衡
├── proxy/               # API 处理 & Kiro 客户端
│   ├── handler.go       # HTTP 路由 & 管理 API
│   ├── kiro.go          # Kiro API 客户端
│   ├── kiro_api.go      # Kiro REST API（用量、模型）
│   └── translator.go    # 请求/响应转换
├── auth/                # 认证
│   ├── iam_sso.go       # IAM SSO 登录
│   ├── oidc.go          # OIDC Token 刷新
│   └── sso_token.go     # SSO Token 导入
├── web/                 # 管理面板前端
├── Dockerfile
└── docker-compose.yml

免责声明

本项目仅供学习和研究目的使用。

本软件与 Amazon、AWS 或 Kiro 没有任何关联、认可或合作关系
用户需自行确保其使用行为符合所有适用的服务条款和法律法规
作者不对因使用本软件而产生的任何滥用或违规行为承担责任
使用风险自负

使用本软件即表示您已阅读并理解本免责声明。

许可证

MIT

4.9 KiB Raw Blame History Unescape Escape