kiro_proxy/docs/04-api.md

API 参考

代理端点

OpenAI 协议

POST /v1/chat/completions

Chat Completions API，兼容 OpenAI 格式。

请求示例：

{
  "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 格式。

请求示例：

{
  "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	导入配置