# kiro-api
**Repository Path**: qq980911302/kiro-api
## Basic Information
- **Project Name**: kiro-api
- **Description**: Kiro API (AWS CodeWhisperer) 代理接口
通过任何 OpenAI 或 Anthropic 兼容工具使用 Claude 模型
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-07-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Kiro API
**Kiro API (AWS CodeWhisperer) 代理接口**
[](https://www.python.org/downloads/)
[](https://fastapi.tiangolo.com/)
*通过任何 OpenAI 或 Anthropic 兼容工具使用 Claude 模型*
[模型](#-支持的模型) • [特性](#-特性) • [快速开始](#-快速开始) • [Dashboard](#-dashboard) • [管理后台](#-管理后台)
---
## 🤖 支持的模型
🧠 **Claude Opus 4.5** — 最强大的模型。适合复杂推理、深度分析和研究任务。
🚀 **Claude Sonnet 4.5** — 性能均衡。适合编程、写作和通用任务。
⚡ **Claude Haiku 4.5** — 闪电般快速。适合快速响应、简单任务和聊天。
📦 **Claude Sonnet 4** — 上一代模型。对大多数用例仍然强大可靠。
📦 **Claude 3.7 Sonnet** — 传统模型。可用于向后兼容。
> 💡 **智能模型解析:** 使用任何模型名称格式 — `claude-sonnet-4-5`、`claude-sonnet-4.5` 或带版本的名称如 `claude-sonnet-4-5-20250929`。网关会自动规范化它们。
---
## ✨ 特性
| 特性 | 描述 |
|---------|-------------|
| 🔌 **OpenAI 兼容 API** | 适用于任何 OpenAI 兼容工具 |
| 🔌 **Anthropic 兼容 API** | 原生 `/v1/messages` 端点 |
| 🧠 **扩展思考** | 推理功能是我们项目的独家特性 |
| 👁️ **视觉支持** | 向模型发送图像 |
| 🛠️ **工具调用** | 支持函数调用 |
| 💬 **完整消息历史** | 传递完整对话上下文 |
| 📡 **流式传输** | 完整的 SSE 流式支持 |
| 🔄 **重试逻辑** | 错误时自动重试 (403, 429, 5xx) |
| 📋 **扩展模型列表** | 包括带版本的模型 |
| 🔐 **智能令牌管理** | 过期前自动刷新 |
| 🎯 **多账号负载均衡** | 支持多个 Kiro 账号,自动负载均衡 |
| 📊 **实时监控仪表板** | 查看请求统计、模型列表、使用情况 |
| ⚙️ **Web 管理后台** | 通过浏览器管理账号、查询额度 |
---
## 🚀 快速开始
### 方式 1:Docker 部署(推荐)
```bash
# 克隆仓库
git clone http://zhanglinlin.top:5454/zhanglinlin/kiro-api.git
cd kiro-api/docker
# 一键启动(使用默认配置)
docker-compose up -d
# 查看日志
docker-compose logs -f
```
**默认配置(开箱即用):**
- 🔑 API Key: `kiroapi`
- 👤 管理员账号: `admin`
- 🔐 管理员密码: `admin123`
- 🌐 服务地址: http://localhost:8000
详细说明请查看 [Docker 部署文档](docker/README.md)
### 方式 2:Python 直接运行
```bash
# 克隆仓库
git clone http://zhanglinlin.top:5454/zhanglinlin/kiro-api.git
cd kiro-api
# 安装依赖
pip install -r requirements.txt
# 启动服务器(使用默认配置)
python main.py
# 或使用自定义端口
python main.py --port 9000
```
服务器将在 `http://localhost:8000` 上运行
**默认配置:**
- API Key: `kiroapi`
- 管理员: `admin` / `admin123`
如需修改,创建 `.env` 文件(参考 `.env.example`)
---
## ⚙️ 配置
### 默认配置(无需修改)
项目已设置默认值,可直接使用:
| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `PROXY_API_KEY` | `kiroapi` | API 访问密钥 |
| `ADMIN_USERNAME` | `admin` | 管理员账号 |
| `ADMIN_PASSWORD` | `admin123` | 管理员密码 |
| `SERVER_HOST` | `0.0.0.0` | 监听地址 |
| `SERVER_PORT` | `8000` | 服务端口 |
| `KIRO_REGION` | `us-east-1` | AWS 区域 |
### 自定义配置(可选)
如需修改默认值,在项目根目录创建 `.env` 文件:
```env
# API 访问密钥(默认: kiroapi)
PROXY_API_KEY="your-secure-password-123"
# 管理后台账号密码(默认: admin/admin123)
ADMIN_USERNAME="admin"
ADMIN_PASSWORD="your-admin-password"
# 可选配置
SERVER_HOST="0.0.0.0"
SERVER_PORT=8000
KIRO_REGION="us-east-1"
```
### 账号管理
#### 通过 Web 管理后台添加(推荐)
1. 访问管理后台:`http://localhost:8000/admin`
2. 使用默认账号登录:
- 账号:`admin`
- 密码:`admin123`
3. 点击"开始设备登录"
4. 在浏览器中打开验证链接并输入验证码
5. 完成 AWS Builder ID 授权
6. 账号自动添加到系统
> 💡 **提示:** 支持添加多个账号,系统会自动负载均衡
---
## 📊 管理后台
### 访问管理后台
访问 `http://localhost:8000/admin` 进入管理后台。
### 功能说明
#### 1. 账号管理
- **添加账号**:通过 AWS 设备授权流程添加新账号
- **查看账号列表**:显示所有已添加的账号及其状态
- **查询额度**:查看每个账号的剩余额度和使用情况
- **删除账号**:移除不需要的账号
#### 2. 设备登录流程
1. 点击"开始设备登录"按钮
2. 系统生成验证码和验证链接
3. 在新标签页打开验证链接
4. 输入验证码并使用 AWS Builder ID 登录
5. 授权完成后账号自动添加
#### 3. 账号状态监控
- 实时显示账号有效性
- 显示令牌过期时间
- 显示账号所在区域
---
## 📈 Dashboard
访问 `http://localhost:8000/dashboard` 查看实时监控面板。
### 面板功能
- **服务状态**:显示网关运行状态
- **剩余额度**:显示所有账号的总剩余额度
- **使用率**:显示额度使用百分比
- **今日请求**:显示今天的请求总数
- **账号数量**:显示已添加的账号数量
- **可用模型**:列出所有可用的 Claude 模型
- **请求记录**:实时显示最近的 API 请求
---
## 📡 API 端点
### 核心端点
| 端点 | 方法 | 描述 |
|----------|--------|-------------|
| `/dashboard` | GET | 监控面板 |
| `/health` | GET | 健康检查 |
| `/v1/models` | GET | 列出可用模型 |
| `/v1/chat/completions` | POST | OpenAI Chat Completions API |
| `/v1/messages` | POST | Anthropic Messages API |
### 管理端点
| 端点 | 方法 | 描述 |
|----------|--------|-------------|
| `/admin` | GET | 管理后台页面 |
| `/admin/login` | POST | 管理员登录 |
| `/admin/accounts` | GET | 获取账号列表 |
| `/admin/accounts/{id}` | DELETE | 删除账号 |
| `/admin/accounts/{id}/usage` | GET | 查询账号额度 |
| `/admin/login/start` | POST | 开始设备登录 |
| `/admin/login/poll` | GET | 轮询登录状态 |
| `/admin/login/cancel` | POST | 取消登录 |
### 统计端点
| 端点 | 方法 | 描述 |
|----------|--------|-------------|
| `/api/stats` | GET | 获取请求统计 |
| `/api/usage` | GET | 获取使用情况 |
---
## 💡 使用示例
### OpenAI API
🔹 简单的 cURL 请求
```bash
curl http://localhost:8000/v1/chat/completions \
-H "Authorization: Bearer kiroapi" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"messages": [{"role": "user", "content": "你好!"}],
"stream": true
}'
```
> **注意:** 默认 API Key 是 `kiroapi`,如已自定义请替换。
🐍 Python OpenAI SDK
```python
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:8000/v1",
api_key="kiroapi" # 默认 API Key
)
response = client.chat.completions.create(
model="claude-sonnet-4-5",
messages=[
{"role": "system", "content": "你是一个有帮助的助手。"},
{"role": "user", "content": "你好!"}
],
stream=True
)
for chunk in response:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
```
🦜 LangChain
```python
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="http://localhost:8000/v1",
api_key="kiroapi", # 默认 API Key
model="claude-sonnet-4-5"
)
response = llm.invoke("你好,你好吗?")
print(response.content)
```
### Anthropic API
🔹 简单的 cURL 请求
```bash
curl http://localhost:8000/v1/messages \
-H "x-api-key: kiroapi" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好!"}]
}'
```
> **注意:** Anthropic API 使用 `x-api-key` 头而不是 `Authorization: Bearer`。默认 API Key 是 `kiroapi`。
🐍 Python Anthropic SDK
```python
import anthropic
client = anthropic.Anthropic(
api_key="kiroapi", # 默认 API Key
base_url="http://localhost:8000"
)
response = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
messages=[{"role": "user", "content": "你好!"}]
)
print(response.content[0].text)
```
---
## 🎯 多账号负载均衡
### 工作原理
网关支持同时使用多个 Kiro 账号,并自动进行负载均衡:
1. **自动选择**:每次请求自动选择可用账号
2. **令牌管理**:自动刷新过期的访问令牌
3. **故障转移**:某个账号失败时自动切换到其他账号
4. **额度监控**:实时监控每个账号的剩余额度
### 添加多个账号
通过管理后台多次执行"设备登录"流程,即可添加多个账号。系统会自动在这些账号之间进行负载均衡。
---
## 🔧 调试
调试日志**默认禁用**。要启用,请在 `.env` 中添加:
```env
# 调试日志模式:
# - off: 禁用(默认)
# - errors: 仅保存失败请求的日志 (4xx, 5xx) - 推荐用于故障排除
# - all: 保存每个请求的日志(每次请求覆盖)
DEBUG_MODE=errors
```
### 调试文件
启用后,请求将记录到 `debug_logs/` 文件夹:
| 文件 | 描述 |
|------|-------------|
| `request_body.json` | 来自客户端的传入请求 |
| `kiro_request_body.json` | 发送到 Kiro API 的请求 |
| `response_stream_raw.txt` | 来自 Kiro 的原始流 |
| `response_stream_modified.txt` | 转换后的流 |
| `app_logs.txt` | 应用程序日志 |
| `error_info.json` | 错误详情(仅在错误时) |
---
**[⬆ 返回顶部](#-kiro-api)**