# 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) 代理接口** [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![FastAPI](https://img.shields.io/badge/FastAPI-0.100+-green.svg)](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)**