API‐Reference

API 参考

端点列表

协议	方法	端点	用途
OpenAI	POST	/v1/chat/completions	聊天补全
OpenAI	GET	/v1/models	模型列表
Anthropic	POST	/v1/messages	Claude 消息
Gemini	POST	/v1/models/{model}:generateContent	Gemini 生成

管理 API

方法	端点	用途
GET	/api/status	服务状态
GET	/api/stats	统计信息
GET	/api/logs	请求日志
GET	/api/accounts	账号列表
POST	/api/accounts/scan	扫描 Token
POST	/api/speedtest	延迟测试

调用示例

OpenAI 格式

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
Anthropic 格式
curl http://localhost:8080/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: any" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'
Python SDK
from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8080/v1",
    api_key="not-needed"
)

response = client.chat.completions.create(
    model="claude-sonnet-4",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)
流式响应
stream = client.chat.completions.create(
    model="claude-sonnet-4",
    messages=[{"role": "user", "content": "Hello"}],
    stream=True
)
for chunk in stream:
    print(chunk.choices[0].delta.content, end="")


---

**FAQ 页面：**

```markdown
# 常见问题

## Token 相关

### Q: 提示 "bearer token is invalid"

**原因**: Token 过期

**解决**:
1. 打开 Kiro IDE 重新登录
2. 在 Web UI 点击「扫描 Token」刷新

### Q: Token 在哪里？

Token 保存在 `~/.aws/sso/cache/` 目录下的 JSON 文件中。

---

## 对话相关

### Q: 提示 "Input is too long"

**原因**: Kiro API 有输入长度限制

**解决**:
1. 在 Claude Code 中输入 `/clear` 清空会话
2. 重新描述任务，Claude 会读取代码恢复上下文

### Q: 如何保持长对话？

目前无法绕过 Kiro 的长度限制。建议：
- 复杂任务分阶段完成
- 每个阶段结束后 `/clear`
- 定期 git commit 保存进度

---

## 连接相关

### Q: 返回 500 错误

检查：
1. Token 是否有效（Web UI 查看账号状态）
2. 网络是否正常
3. 查看控制台日志定位具体错误

### Q: 429 限流

KiroProxy 会自动切换到其他可用账号。如果所有账号都被限流：
- 等待几分钟后重试
- 添加更多账号

---

## 其他

### Q: 支持哪些客户端？

| 客户端 | 状态 |
|--------|------|
| Claude Code (VSCode) | ✅ 完全支持 |
| Codex CLI | ⚠️ 理论兼容 |
| Gemini CLI | ⚠️ 理论兼容 |
| Claude Code CLI | ⚠️ 理论兼容 |

### Q: 如何添加多账号？

1. 在不同浏览器/设备登录不同 Kiro 账号
2. 每个账号的 token 会保存为不同文件
3. 在 Web UI 扫描并添加所有 token