ImgRouter — 画像生成API中継サービス
概要
ImgRouterは「三合一图像生成 API 中转服务」を掲げる軽量なAPI中継(ルーター)です。クライアントはOpenAI互換のAPIフォーマットでリクエストを投げるだけで、サービス側が受け取ったAPIキーの形式に応じて自動的に対応する画像生成チャネル(火山引擎、Gitee の模力方舟、ModelScope の魔塔)へ振り分けます。デプロイはDeno実行環境とDockerをサポートし、SSEによるストリーミングレスポンスや参考画像のアップロード機能も備えています。ミニマルな設定で複数ベンダーを横断する画像生成ワークフローを実現します。
リポジトリの統計情報
- スター数: 18
- フォーク数: 2
- ウォッチャー数: 18
- コミット数: 6
- ファイル数: 12
- メインの言語: TypeScript
主な特徴
- APIキーのフォーマットを解析して自動的にチャネルルーティング
- 火山引擎・Gitee(模力方舟)・ModelScope(魔塔)の三チャネルをサポート
- OpenAI互換のエンドポイント(/v1/chat/completions)を実装
- SSEストリーミング・画像参照アップロードに対応、Dockerで容易に配備可能
技術的なポイント
ImgRouterはTypeScriptで実装され、Denoランタイムを想定した設計になっています。設計上のキーは「スマートルーティング」で、受け取ったリクエストに含まれるAPIキーの形式(プレフィックスや構造)を識別して、どのバックエンド(火山引擎、模力方舟、魔塔)へ転送するかを決定します。これによりクライアントはチャネルごとに異なるエンドポイントや認証方法を意識せずに済み、統一されたOpenAI互換APIで操作できます。
互換性の面では、/v1/chat/completions のリクエスト/レスポンスフォーマットに合わせており、既存のOpenAIクライアントやツールからの移行が容易です。レスポンスは通常のHTTP応答に加え、SSE(Server-Sent Events)を用いたストリーミング出力をサポートしているため、長時間処理や段階的な画像生成の結果をリアルタイムにクライアントへ伝播できます。
また、画像生成における「画像参考(参考画像)」の取り扱いにも配慮しており、クライアントから画像をアップロードしてその参照をリクエストに含めるフローを提供します。これによりテキストプロンプトに加えて具体的な画像をガイドとして使うことが可能です。
運用面では、軽量コンテナ(Docker)化とDeno対応により、簡単にクラウドあるいはオンプレミスへデプロイできます。MITライセンスで公開されており、必要に応じてカスタマイズして自社APIの前段に組み込むプラットフォームとして利用できます。設計はシンプルで拡張しやすく、新たな画像生成チャネルを追加するための拡張ポイントも取り入れやすくなっています。
プロジェクトの構成
主要なファイルとディレクトリ:
- .gitignore: file
- .roomodes: file
- .rooroo: dir
- .vscode: dir
- Dockerfile: file
…他 7 ファイル
まとめ
シンプルで拡張しやすい、マルチチャネル画像生成の中継基盤。
リポジトリ情報:
- 名前: img-router
- 説明: 三合一图像生成 API 中转服务- 一个接口,多渠道图像生成
- スター数: 18
- 言語: TypeScript
- URL: https://github.com/lianwusuoai/img-router
- オーナー: lianwusuoai
- アバター: https://avatars.githubusercontent.com/u/87284545?v=4
READMEの抜粋:
ImgRouter
三合一图像生成 API 中转服务 - 一个接口,多渠道图像生成
特性
- 智能路由 - 根据 API Key 格式自动识别并分发到对应渠道
- 三渠道支持 - 火山引擎、Gitee (模力方舟)、ModelScope (魔塔)
- OpenAI 兼容 - 完全兼容
/v1/chat/completions接口格式 - 流式响应 - 支持 SSE 流式输出
- 图片参考 - 支持上传参考图片进…