pingmike2/freebuff2api-wokers

解決する課題

このプロジェクトは、freebuff/codebuff の無料 AI モデルを使用する際の手間を解消します。通常、ログイントークンの管理、日次利用制限（Freebucks と呼ばれる）の追跡、そして制限に達した際のアカウント切り替えを自分で行う必要があります。このサービスは、それらの無料モデルを標準的な OpenAI 互換 API にラップするため、あらゆる OpenAI または Anthropic クライアントを接続するだけで、面倒なアカウント、クォータ、セッション管理をすべて自動化できます。

仕組み

このサービスは、軽量なサーバー（依存関係のない単一ファイル）として動作し、OpenAI 形式のリクエストを受け付けます。バックグラウンドで freebuff アカウントのプールを保持します。チャットリクエストを行うと、まだクレジットが残っているアカウントを選択し、セッション（約1時間持続）を使用して無料モデルを呼び出し、標準形式で結果を返します。また、Web 管理パネル（/admin）が含まれており、アカウントトークンの追加・削除、アカウントごとのプロキシ設定、各アカウントの残り Freebucks の確認、API 設定の調整が可能です。すべての変更は再起動なしで即座に適用されます。OpenAI および Anthropic API 形式の両方をサポートしており、稼働状況監視用のヘルスチェックエンドポイントも備えています。

対象ユーザー

DeepSeek、Kimi、GLM などの無料 AI モデルを、お気に入りの OpenAI 互換ツールを通じて利用したい開発者、愛好家、または小規模チーム向けです。アカウントのローテーション、クォータ追跡、API ゲートウェイを自前で構築・保守したくない場合に最適です。複数の無料アカウントを管理して日次利用量を増やしたい場合や、既存のクライアントにこれらのモデルを簡単に公開したい場合に特に役立ちます。

特徴

• Docker や VPS で実行可能な、依存関係のないシングルファイルコード。
• アカウント、プロキシ、API キーの管理や Freebucks 残高をリアルタイムで確認できる Web 管理パネル。
• 多アカウント自動切り替え：アカウントが日次制限に達すると、自動的にクールダウンし、別のアカウントに切り替わります。
• スマートなセッション再利用：セッションは約1時間持続し、クレジット使用量を最大化するために同一アカウントに固定されます。
• OpenAI (/v1/chat/completions) および Anthropic (/v1/messages) API の両方と互換性があります。
• 稼働状況監視用のヘルスチェックエンドポイント。
• Docker でのデプロイを推奨します。Cloudflare Worker でのデプロイはアカウント停止のリスクがあるため推奨されません。