Kiro2API — Kiro IDEをOpenAI/Claude互換APIに変換するサービス
概要
Kiro2APIは、Kiro IDE(Kiro AI)をそのまま外部のチャットAPI(OpenAI/Claude互換)として扱えるように橋渡しするプロジェクトです。Claudeの/v1/messagesエンドポイントとOpenAIの/v1/chat/completionsエンドポイントの両方をサポートし、プロキシプール、セッション派生(%sプレースホルダでSession IDを注入)、複数アカウントの負荷分散と障害回避、自動リトライやキャプチャ対応など、実運用で求められる運用性を備えています。設定はconfig.yamlや.env.exampleで管理し、SQLiteで状態を保持するためバックアップや移行も容易です。シェル中心の軽量な構成なので簡単にデプロイして既存環境へ組み込めます。
リポジトリの統計情報
- スター数: 9
- フォーク数: 3
- ウォッチャー数: 9
- コミット数: 7
- ファイル数: 7
- メインの言語: Shell
主な特徴
- Claude(/v1/messages)とOpenAI(/v1/chat/completions)の両プロトコル互換を提供
- HTTP/HTTPS/SOCKS5対応のプロキシプールと、%sでSession IDを注入するセッション派生
- 複数アカウントのランダム割当・異常アカウント自動スキップによる負荷分散
- 自動リトライ(回数・遅延・キャプチャ対応)、SQLiteによるデータ永続化
技術的なポイント
Kiro2APIの技術的な核は「プロトコル変換」と「運用性の担保」にあります。まずプロトコル変換については、Kiro側のリクエストやレスポンスをClaude互換の/v1/messagesおよびOpenAI互換の/v1/chat/completionsの両方のフォーマットへマッピングする処理を提供します。これにより、クライアントは標準的なOpenAI/Claude互換APIとしてKiroを叩けます。
運用面では、プロキシプールの設計が特徴的です。HTTP/HTTPS/SOCKS5をサポートし、config内で複数のプロキシを定義、輪番またはランダムで選択して送信します。さらにプロキシ文字列に%sプレースホルダを置くことで、実行時にアカウント固有のSession IDを埋め込み、送信元IPやセッションをアカウント単位に分離できます(IP隔離)。これにより同一アカウントのトラフィックが常に同一プロキシを通るような運用や、逆に均等分散を任意に実現可能です。
負荷分散とフェイルオーバーは、複数アカウントをランダムに割り当て、失敗したアカウントは一時的にスキップする仕組みで担保しています。リトライ機構は可変の回数・遅延設定を持ち、キャプチャ(認証の壁)検知時の再試行ロジックも備えています。内部状態やアカウント情報、エラーログはSQLiteに永続化され、データのバックアップや他環境への移行が容易です。
実装はシェルスクリプト中心で軽量なため、リソースの少ないサーバでも動作します。設定ファイル(config.yaml)と環境変数(.env.example)で挙動を変更でき、deploy.shによりセットアップや起動を自動化できます。外部に公開する際のエンドポイントの互換性を維持しつつ、内部でプロキシやアカウントを巧妙に管理する点がプロダクション運用に向いた設計です。
プロジェクトの構成
主要なファイルとディレクトリ:
- .env.example: file
- README.md: file
- augment.vscode-augment.0.754.0.byok-internal.vsix: file
- config.yaml: file
- deploy.sh: file
…他 2 ファイル
(補足)config.yamlでプロキシやアカウント情報、リトライ設定を管理し、deploy.shで簡単にデプロイできます。augment.vscode-augment…vsixはAugment拡張関連のパッケージと思われ、IDE統合やローカル検証に使われる可能性があります。
まとめ
Kiroを既存のOpenAI/Claude互換ワークフローに組み込むための実用的なブリッジであり、運用重視の設計が光る軽量ツールです(約50字)。
リポジトリ情報:
- 名前: kiro2api
- 説明: 🚀 Kiro to OpenAI API - 将 Kiro IDE 转换为兼容 OpenAI/Claude/Augment Code 格式的 API 服务
- スター数: 9
- 言語: Shell
- URL: https://github.com/ssmDo/kiro2api
- オーナー: ssmDo
- アバター: https://avatars.githubusercontent.com/u/230398796?v=4
READMEの抜粋:
Kiro2API 部署指南
将 Kiro AI 转换为标准 API 服务,支持 Claude 和 OpenAI 兼容协议。
✨ 功能特性
- 🔄 多协议支持 - 同时支持 Claude
/v1/messages和 OpenAI/v1/chat/completions端点 - 🌐 代理池支持 - 支持 HTTP/HTTPS/SOCKS5 代理,可配置代理池轮询
- 🔑 Session 派生 - 代理地址支持
%s占位符,自动替换为账号唯一 Session ID,实现 IP 隔离 - ⚖️ 负载均衡 - 多账号随机分配,自动跳过异常账号
- 🔁 自动重试 - 可配置重试次数、延迟和验证码重试
- 💾 数据持久化 - SQLite 数据库存储,方便备份迁移
项目展示
Kiro2API 首页
📡 API 端点
Claude 协议 (/v1/messages)
curl -X POST http://localhost:800...