Kiira2API — OpenAI互換のFastAPIベースAPI

Web
Kiira2API — OpenAI互換のFastAPIベースAPI

Kiira2API — OpenAI互換のFastAPIベースAPI

Kiira2APIはFastAPIで実装された、OpenAI API形式と互換性のある自己ホスト型APIサーバです。チャット補完（/v1/chat/completions）やモデル照会などを提供し、ストリーミング／非ストリーミング応答に対応。Kiira AIクライアント機能を統合しており、Nano Banana、Sora 2、Veo 3、Midjourneyといったモデル群との連携を想定した設計です。Docker化・環境変数管理・Python 3.11以上を前提としたモジュール化アーキテクチャで、既存のOpenAIクライアントからの移行が容易になります。（約300字）

https://github.com/move132/kiira2api

概要

Kiira2APIは、FastAPI上に構築されたAPIサービスで、OpenAIのAPIフォーマットと互換性を持つチャット補完およびモデルクエリのエンドポイントを提供します。プロジェクトはモジュール化された構造を採用し、内部的にKiira AIクライアント機能を統合することで、バックエンド側のモデル実行やプロキシ機能を担います。ストリーミング応答（逐次送信）と非ストリーミングの両方に対応しており、既存のOpenAI互換クライアントやツールから最小限の変更で利用できる点が特徴です。Docker構成や.envサンプルが用意されており、ローカル／コンテナ環境での立ち上げが容易です。

GitHub

リポジトリの統計情報

  • スター数: 15
  • フォーク数: 8
  • ウォッチャー数: 15
  • コミット数: 2
  • ファイル数: 11
  • メインの言語: Python

主な特徴

  • OpenAI API互換インターフェース（/v1/chat/completions など）を提供し、既存クライアントとの互換性を重視
  • ストリーミング（リアルタイム逐次応答）と非ストリーミングの両対応
  • Kiira AIクライアント統合による複数モデル（例：Nano Banana、Sora 2、Veo 3、Midjourney想定）サポート
  • Docker・.envによる環境構築の標準化と軽量なモジュール構成

技術的なポイント

Kiira2APIはFastAPIを核に、非同期処理、Pydanticによるスキーマ管理、そしてOpenAI API互換のエンドポイント設計を組み合わせたシンプルかつ実用的な実装になっています。設計上の主な狙いは「既存のOpenAIクライアントをほぼそのまま利用できる互換レイヤ」を提供することです。そのため、リクエスト／レスポンスのJSONスキーマ（messages、model、stream等）をOpenAI準拠に整え、クライアント側の変更コストを下げています。

ストリーミング対応は、FastAPIの非同期レスポンス機構（StreamingResponseやイベントソース的な実装）を通じて実現されている想定で、長時間実行されるモデル応答をチャンク単位でクライアントへ送信できます。これによりチャットUIでの逐次表示や低レイテンシな応答体験が可能です。内部でのモデル呼び出しや外部APIとの接続は抽象化され、Kiiraクライアントモジュールが責務分離を担います。これにより将来的なモデル切替や複数バックエンドの併用が容易になります。

開発運用面では、Dockerfileと.env.exampleが用意されており、環境変数でAPIキー、バックエンドエンドポイント、ログレベルなどを制御できる設計です。Python 3.11+を想定した型安全な実装により、Pydantic v2系や型ヒントを活用した保守性の高いコードベースになっています（README上のバッジからの推定）。セキュリティや認証はOpenAI互換を踏襲する形でHTTPヘッダー（Authorization: Bearer …）を使うことが多く、ミドルウェアや依存注入でのトークン検証を組み込みやすい構造です。

さらに、プロジェクトはモジュール化されているため、エンドポイント・モデル定義・クライアントラッパー・ユーティリティといった責務が分離されており、テストや拡張がしやすい点も評価できます。軽量であるため、オンプレミスやプライベートクラウドにデプロイして、社内向けのOpenAI互換APIを立ち上げる用途にも適しています。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .dockerignore: file
  • .env.example: file
  • .gitignore: file
  • .python-version: file
  • Dockerfile: file

その他の主要ファイル（抜粋）：

  • README.md: プロジェクトの説明と利用方法
  • LICENSE: MITライセンス
  • main.py / app ディレクトリ（想定）: FastAPIアプリケーションのエントリポイント
  • requirements.txt / pyproject.toml（想定）: 依存管理
  • クライアントラッパーやルーター実装ファイル（Kiira接続・API互換レイヤ）

ファイル数は少なめで、エントリポイント、設定、Docker化、環境変数サンプル、ライセンス、ドキュメントが揃っている構成です。必要に応じてルーターやサービス層を追加して拡張する作りになっており、短時間でセルフホスト環境を立ち上げることができます。

まとめ

OpenAI互換の自己ホスト型FastAPIサーバとして、実用的で拡張性のある出発点を提供するリポジトリです（約50字）。

リポジトリ情報：

READMEの抜粋：

Kiira2API

Python FastAPI License

基于 FastAPI 的 API 服务，提供兼容 OpenAI API 格式的聊天完成和模型查询接口。项目采用模块化架构，整合了 Kiira AI 客户端功能。

✨ 特性

  • 🚀 OpenAI API 兼容: 完全兼容 OpenAI API 格式，便于现有客户端集成
  • 💬 聊天完成接口: 支持 /v1/chat/completions 接口，提供流式和非流式响应
  • 🤖 模型查询: 支持 `/v…