File size: 2,926 Bytes
d3cadd5 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 | # API 参考
## 代理端点
### OpenAI 协议
#### POST /v1/chat/completions
Chat Completions API，兼容 OpenAI 格式。
**请求示例：**
```json
{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "Hello!"}
],
"stream": true
}
```
**模型映射：**
| 请求模型 | 实际使用 |
|----------|----------|
| gpt-4o, gpt-4 | claude-sonnet-4 |
| gpt-4o-mini, gpt-3.5-turbo | claude-haiku-4.5 |
| o1, o1-preview | claude-sonnet-4.5 |
#### GET /v1/models
获取可用模型列表。
---
### Anthropic 协议
#### POST /v1/messages
Messages API，兼容 Anthropic 格式。
**请求示例：**
```json
{
"model": "claude-sonnet-4",
"max_tokens": 4096,
"messages": [
{"role": "user", "content": "Hello!"}
]
}
```
#### POST /v1/messages/count_tokens
计算消息的 Token 数量。
---
### Gemini 协议
#### POST /v1/models/{model}:generateContent
Generate Content API，兼容 Gemini 格式。
---
## 管理 API
### 状态与统计
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/status` | GET | 服务状态 |
| `/api/stats` | GET | 基础统计 |
| `/api/stats/detailed` | GET | 详细统计 |
| `/api/quota` | GET | 配额状态 |
| `/api/logs` | GET | 请求日志 |
### 账号管理
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/accounts` | GET | 账号列表 |
| `/api/accounts` | POST | 添加账号 |
| `/api/accounts/{id}` | GET | 账号详情 |
| `/api/accounts/{id}` | DELETE | 删除账号 |
| `/api/accounts/{id}/toggle` | POST | 启用/禁用 |
| `/api/accounts/{id}/refresh` | POST | 刷新 Token |
| `/api/accounts/{id}/restore` | POST | 恢复账号 |
| `/api/accounts/{id}/usage` | GET | 用量查询 |
| `/api/accounts/refresh-all` | POST | 刷新所有 |
### Token 操作
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/token/scan` | GET | 扫描本地 Token |
| `/api/token/add-from-scan` | POST | 从扫描添加 |
| `/api/token/refresh-check` | POST | 检查 Token 状态 |
### 登录
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/kiro/login/start` | POST | 启动 AWS 登录 |
| `/api/kiro/login/poll` | GET | 轮询登录状态 |
| `/api/kiro/login/cancel` | POST | 取消登录 |
| `/api/kiro/social/start` | POST | 启动 Social 登录 |
| `/api/kiro/social/exchange` | POST | 交换 Token |
### Flow 监控
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/flows` | GET | 查询 Flows |
| `/api/flows/stats` | GET | Flow 统计 |
| `/api/flows/{id}` | GET | Flow 详情 |
| `/api/flows/{id}/bookmark` | POST | 收藏 Flow |
| `/api/flows/export` | POST | 导出 Flows |
---
## 配置
### 配置文件位置
- 账号配置：`~/.kiro-proxy/config.json`
- Token 缓存：`~/.aws/sso/cache/`
### 配置导入导出
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/config/export` | GET | 导出配置 |
| `/api/config/import` | POST | 导入配置 |
|