収録件数：264 件のニュース/100 個のAIツール/374 個のオープンソースプロジェクト/64 件の学習リソース
ホームニュースオープンソースモデルAIツール学習リソース
ホーム / オープンソース / sub2api

sub2api

Claude、OpenAI、Gemini、Grokのサブスクリプションを統合し、API互換のエンドポイントを提供するオープンソースのGo製ゲートウェイ。

GoLGPL-3.0Deploy & Inference
⭐ GitHubhttps://github.com/Wei-Shaw/sub2api
34,925
スター数
+0
スター増加率
2026年7月29日
最終更新
4
クリック数

1. プロジェクト概要

Sub2APIは、Claude、OpenAI、Gemini、Grok、Antigravityのサブスクリプションを統合し、OpenAI/Anthropic互換のAPIエンドポイントを統一して提供する、オープンソースのGoベースのAPIゲートウェイです。これにより、チームは共有サブスクリプションのクォータをプールし、単一のセルフホスト型サービスを通じて管理することができます。

2. 背景とポジショニング

個別のAIサブスクリプション（Claude Pro/Max、ChatGPT Plus、Gemini Advancedなど）は、シングルユーザー向けのブラウザベースの利用を想定した価格設定ですが、開発者はネイティブなCLIツールやSDKを通じたプログラムmaticアクセスをますます求めています。Sub2APIはこのギャップを埋めるために構築されました：1つまたは複数のサブスクリプションアカウントをAPI互換のゲートウェイに変換し、チームやコミュニティがクォータを共有し、トークン単位で利用を追跡し、リクエストをアカウントやプロバイダー間でインテリジェントにルーティングできるようにします。

一般的なLLMプロキシやルータープロジェクトが主にAPIキーのトラフィックを転送することに焦点を当てるのに対し、Sub2APIはOAuth認証されたコンシューマープランなどのサブスクリプションベースのアカウントに特化しています。アカウントプーリング、スティッキーセッションスケジューリング、組み込みの請求・決済機能を追加することで、共有アクセスを個人用のスクリプトではなく、小規模なホスト型サービスとして運用できるようにしています。

3. 機能カテゴリ

🔑 アカウントとアクセス管理 — 4つの主要機能。例：OAuthアカウントバインディング、API Keyアカウントバインディング、動的APIキー発行、キーごとのライフサイクル制御。目的：1つのダッシュボードから多くのアップストリームサブスクリプションアカウントとダウンストリームのユーザーキーをオンボーディングおよび管理すること。

⚖️ スケジューリングとトラフィック制御 — 4つの主要機能。例：インテリジェントなアカウント選択、スティッキーセッション、ユーザーごとの同時接続制限、アカウントごとの同時接続制限、構成可能なリクエスト/トークンレート制限。目的：プーリングされたアカウント間に負荷を均等に分散させ、各アカウントがアップストリームでスロットルされたりフラグを立てられたりしないように保護すること。

💳 請求と収益化 — 4つの主要機能。例：トークンレベルの使用量メータリング、組み込みの決済統合（EasyPay、Alipay、WeChat Pay、Stripe）、セルフサービスチャージ、請求サーキットブレーカー。目的：正確で監査可能な使用量会計により、コストシェアリングまたは有料アクセスグループを運営者が実行できるようにすること。

🧩 マルチプロバイダールーティング — 5つのサポートプロバイダー：Claude (Anthropic)、OpenAI (Codexを含む)、Gemini (Google)、Grok/xAI、Antigravity (ハイブリッドスケジューリング)。目的：一貫性があり馴染み深いAPI形状の背後に、多様なアップストリームプロバイダーを配置すること。

🖥️ 管理者ダッシュボードと運用 — 4つの主要機能。例：Vue 3 Webコンソール、リアルタイムモニタリング、Codex CLI用のWebSocketイングレス管理、非同期画像タスクポーリング。目的：日常的なコマンドライン操作を行わずとも、運用者に可視性と制御権限を与えること。

4. 主な特徴

  • サブスクリプションプーリング（「相乗り」） — 複数のClaude/OpenAI/Gemini/Grokアカウントを1つのゲートウェイに組み合わせ、チームやユーザーベース全体でクォータコストを共有できます。
  • ネイティブツールとの互換性 — Anthropic/OpenAIスタイルのAPIに対して構築された既存のCLIツールやSDKが、最小限の変更または変更なしで動作するように設計されています。
  • トークン単位の精密な請求 — すべてのリクエストがトークンレベルでメータリングされるため、公平なコスト配分や従量課金のチャージが可能になります。
  • スティッキーセッションによるスマートスケジューリング — 必要に応じて会話を同じアップストリームアカウントに固定し、マルチターンツールセッション全体でコンテキストが失われるのを防ぎます。
  • 複合プロバイダーグループ — 冗長性と負荷分散のために、単一の論理モデルエンドポイントを複数のプロバイダーやアカウント間でルーティングします。
  • 複数のデプロイメントパス — ワンライナーインストールスクリプト、Docker Compose、Apple Container (macOS/Apple Silicon)、またはソースからのビルドに対応しており、迅速な試行から本番環境への展開までカバーします。

5. ロール別のユースケース

  • 一般開発者: 各プロバイダーごとに別々のSDKや資格情報を扱うことなく、1つの一貫したAPIエンドポイントとAPIキーを通じてClaude、OpenAI、Gemini、Grokにアクセスできます。
  • DevOps/SRE: PostgreSQLとRedisを使用してDocker Composeでデプロイし、レート制限、信頼できるプロキシ、サーキットブレーカーを設定して、負荷下でも共有ゲートウェイの安定性を維持します。
  • コミュニティ/チーム運営者: グループ内でサブスクリプションコストをプールし、個別のAPIキーを発行し、組み込みの決済統合を使用して共有または有料アクセスを管理します。
  • プロジェクトマネージャー: エンジニアリングサポートを必要とせずに、組織全体の使用状況、支出、アカウントの健全性を監視するために管理者ダッシュボードを使用します。

6. はじめに

必要なものを見つける — リポジトリのREADME（英語および中文）と、デプロイメント固有のガイダンスについては deploy/README.md から始めてください：

git clone https://github.com/Wei-Shaw/sub2api.git

インストール / インテグレーション — 最も速い方法はLinux用のワンライナーインストールスクリプトです：

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

または、完全にコンテナ化されたセットアップにはDocker Composeを使用します（PostgreSQLとRedisが含まれます）：

mkdir -p sub2api-deploy && cd sub2api-deploy
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash
docker compose up -d

コントリビューション — リポジトリをフォークし、main に対してプルリクエストを開き、GitHub Issuesを使用してバグを報告したり機能を提案してください：

gh repo fork Wei-Shaw/sub2api --clone

7. プロジェクト構造

sub2api/
├── backend/     # Goサービス: 設定、モデル、リクエストハンドラ、プロバイダーゲートウェイロジック
├── frontend/    # Vue 3 + Vite + TailwindCSS 管理者ダッシュボード
├── deploy/      # Docker Composeファイル、envテンプレート、インストール/アップグレードスクリプト
└── openspec/    # 公開されるゲートウェイエンドポイント用のOpenAPI仕様
  • backend/cmd/server — Goバイナリのメインエントリーポイント。
  • deploy/install.sh / deploy/docker-deploy.sh — スクリプトベースおよびDockerベースのデプロイメント用のワンライナーインストーラー。
  • frontend/ — アカウント、キー、請求、モニタリング管理に使用されるWebコンソール。

8. 関連エコシステム

  • アップストリーム依存関係: バックエンドではGo 1.25.7、Ginウェブフレームワーク、Ent ORMを使用；フロントエンドではVue 3.4+、Vite 5+、TailwindCSSを使用；ストレージにはPostgreSQL 15+、キャッシュおよびキューにはRedis 7+を使用。
  • アップストリームサブスクリプションプロバイダー: Anthropic (Claude)、OpenAI (Codexを含む)、Google (Gemini)、xAI (Grok) — Sub2APIはこれらの上にゲートウェイとして位置づけ、それらを置き換えるものではありません。
  • コンパニオンプロジェクト: sub2api-mobile — 外出先からデプロイされたインスタンスを管理するためのクロスプラットフォームモバイル管理者コンソール。

9. ライセンス

Sub2APIは GNU Lesser General Public License v3.0 (LGPL-3.0) の下でリリースされています。

  • ✅ ソースコードの使用、研究、改変は無料です（内部または教育目的を含む）。
  • ✅ 個人またはチームでのセルフホスティングは無料です（プライベートグループ内でのサブスクリプションコスト共有を含む）。
  • ❌ プロジェクトは、個人または組織による商業サービスとしての運用を承認していないことを明確に表明しています。
  • ℹ️ Sub2APIを使用してアップストリームプロバイダーにアクセスすることは、それらのプロバイダー独自の利用規約に抵触する可能性があります。メンテナーは、このプロジェクトが技術的な学習および研究目的で意図されていると説明しており、運用者は自身のコンプライアンスとアカウントリスクについて責任を負います。

10. FAQ

Q: Sub2APIはどのAIプロバイダーをサポートしていますか？
A: Claude (Anthropic)、OpenAI (Codexを含む)、Gemini (Google)、Grok/xAI、Antigravityを、互換性のあるAPIエンドポイントの背後で統一しています。現在のリストについてはREADMEをご覧ください。

Q: 試すための最速の方法は何ですか？
A: Docker Composeのクイックスタートを使用します。これにより、ゲートウェイとともにPostgreSQLとRedisが自動的にプロビジョニングされます：

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

Q: サブスクリプションアカウントに対してSub2APIを実行することは、プロバイダーのルールに違反しますか？
A: メンテナーは、アップストリームプロバイダーの利用規約に抵触する可能性があることに注意し、アカウントBANに関する責任を免責しています。デプロイする前に、README のライセンスと免責事項を確認してください。

Q: Sub2APIを使用して他者のために有料サービスを実行できますか？
A: プロジェクトには、グループ内でのコストシェアリングのための組み込み決済統合（EasyPay、Alipay、WeChat Pay、Stripe）が含まれていますが、メンテナーはプロジェクト自体の商業的運用を承認していません。まずライセンス条項を確認してください。

Q: バグ報告や機能リクエストはどこで行うのですか？
A: メインリポジトリのGithub Issues を通じて行ってください。

11. クイックリンク

12. まとめ

Sub2APIは、散在するAIサブスクリプションアカウントを、トークン単位の請求、スマートスケジューリング、完全な管理者ダッシュボードを備えた、管理可能でAPI互換の1つのゲートウェイに変換します。これは、Claude、OpenAI、Gemini、Grokに一貫したインターフェースを通じてアクセスし、サブスクリプションコストを共有したい開発者や小規模チームにとって最適ですが、デプロイする前にアップストリーム利用規約とライセンスの影響を慎重に確認する必要があります。