MCPcopy
hub / github.com/Wei-Shaw/sub2api

github.com/Wei-Shaw/sub2api @v0.1.143 sqlite

repository ↗ · DeepWiki ↗ · release v0.1.143 ↗
46,057 symbols 135,283 edges 1,938 files 28,513 documented · 62%
README

Sub2API

Go Vue PostgreSQL Redis Docker

Wei-Shaw%2Fsub2api | Trendshift

サブスクリプションクォータ配分のための AI API ゲートウェイプラットフォーム

English | 中文 | 日本語

⚠️ 重要なお知らせ

本プロジェクトをご利用になる前に、以下の内容を必ずよくお読みください:

  • 🚨 利用規約のリスク:本プロジェクトの使用は、Anthropic をはじめとする上流プロバイダーの利用規約に違反する可能性があります。ご利用前に各プロバイダーのユーザー規約を必ずご確認ください。使用により生じるすべてのリスクはユーザーご自身が負うものとします。
  • ⚖️ 法令遵守:お住まいの国または地域の法令を遵守した上で本プロジェクトをご利用ください。いかなる違法な目的での使用も固く禁じます。
  • 📖 免責事項:本プロジェクトは技術的な学習および研究の目的でのみ提供されます。本プロジェクトの使用により生じたアカウントの停止、サービスの中断、データの損失、その他一切の直接的または間接的な損害について、作者は一切の責任を負いません。

❤️ スポンサー

こちらに掲載しませんか?

openmodel 1つの API で、トップモデルを使い放題!OpenModel は本番環境グレードで高可用性の AI API ゲートウェイに特化し、アプリを真に高速・安定させます:自動フェイルオーバー、最適なチャネルへのスマートルーティング、本番グレードの SLA 保証。単一プロバイダーをはるかに上回る SLA で、安定性をあなたの核心的な競争力にします。
ETok ETok.ai のご支援に感謝します!ETok.ai はワンストップ AI プログラミングツールサービスプラットフォームの構築に取り組んでいます。Claude Code の専用プランと技術コミュニティサービスを提供し、Google Gemini や OpenAI Codex もサポートしています。丁寧に設計されたプランと専門的な技術コミュニティを通じて、開発者に安定したサービス保証と継続的な技術サポートを提供し、AI アシスト プログラミングを真の生産性向上ツールにします。こちらから登録!
AIGoCode AIGoCode のご支援に感謝します!AIGoCode は Claude Code、Codex、最新の Gemini モデルを統合したオールインワンプラットフォームで、安定的かつ効率的でコストパフォーマンスに優れた AI コーディングサービスを提供します。柔軟なサブスクリプションプラン、アカウント停止リスクゼロ、VPN 不要の直接アクセス、超高速レスポンスが特長です。AIGoCode は sub2api ユーザー向けに特別特典を用意しています:こちらのリンクから登録すると、初回チャージ時に 10% のボーナスクレジットを追加プレゼント!
AICodeMirror AICodeMirror のご支援に感謝します!AICodeMirror は Claude Code / Codex / Gemini CLI の公式高安定性リレーサービスを提供しており、エンタープライズグレードの同時実行、迅速な請求書発行、24時間年中無休の専属テクニカルサポートを備えています。Claude Code / Codex / Gemini の公式チャネルを定価の 38% / 2% / 9% で利用可能、チャージ時にはさらに追加割引!AICodeMirror は sub2api ユーザー向けに特別特典を提供中:こちらのリンクから登録すると、初回チャージが 20% オフ、法人のお客様は最大 25% オフ!
bmoplus 本プロジェクトにご支援いただいた BmoPlus に感謝いたします!BmoPlusは、AIサブスクリプションのヘビーユーザー向けに特化した信頼性の高いAIアカウントサービスプロバイダーであり、安定した ChatGPT Plus / ChatGPT Pro (完全保証) / Claude Pro / Super Grok / Gemini Pro の公式代行チャージおよび即納アカウントを提供しています。こちらのBmoPlus AIアカウント専門店/代行チャージ経由でご登録・ご注文いただいたユーザー様は、GPTを 公式サイト価格の約1割(90% OFF) という驚異的な価格でご利用いただけます!
bestproxy Bestproxy のご支援に感謝します!Bestproxy は高純度の住宅IPを提供し、1アカウント1IP専有をサポートしています。実際の家庭ネットワークとフィンガープリント分離を組み合わせることで、リンク環境の分離を実現し、関連付けによるリスク管理の確率を低減します。
pateway PatewayAI のご支援に感謝します!PatewayAI は、ヘビーAI開発者向けに公式直結を重視した高品質モデルAPIリレーサービスプロバイダーです。Claude 全シリーズおよび Codex シリーズモデルを提供し、100%公式ソースから直接供給 — 偽りなし、水増しなし、検証歓迎。課金は完全透明で、トークン単位の請求書を1件ずつ監査可能です。 エンタープライズ級の高同時接続にも対応し、法人顧客向けに専用管理プラットフォームを提供しています。法人顧客は正式な契約を締結し、請求書の発行が可能です。詳細は公式サイトでお問い合わせください。 こちらのリンクから登録すると、$3 のトライアルクレジットがもらえます。チャージは最大40%オフ、友達紹介で双方にボーナス付与 — 紹介報酬は最大 $150。
pptoken PPToken.org のご支援に感謝します!PPToken.org は GPT シリーズモデルの API 中継サービスを専門としており、Codex、Claude Code、OpenAI 互換クライアント、Gemini CLI などのツール接続をサポートしています。チャージは 1:1(1元=1ドル分のクレジット)、GPT モデルは最低 0.16 倍のレート倍率で、総合コストは公式価格の約 2.2% 、最速ファーストトークンは約1秒 — 開発者が低コスト・高速レスポンスで GPT モデル機能にアクセスするのに最適です。テクニカルサポート:24時間365日リアルな人間が対応(ボットではありません)、グループ内で @技術 すれば 10 分以内に返信。スポンサー特典:先着 200 名のユーザーが専用登録リンクから登録し、プロモコード `SUB2API` を入力すると、Codex / Claude Code の無料トライアルクレジットを獲得できます — 最低利用額なし、カード登録不要。
unity2 Unity2 のご支援に感謝します!Unity2 は個人開発者、チーム、企業向けの高性能 AI モデル API 中継プラットフォームです。中国の大手企業に長期にわたりサービスを提供しており、1日あたり 300 億以上のトークン呼び出しを処理し、5000 RPM 級の高並列性をサポートします。1つの API キーで Claude Code、Codex、OpenAI モデル、IDE プラグイン、Agent ワークフローなど様々なシナリオに対応できます。エンタープライズグレードの安定供給能力を備え、高並列・継続的な呼び出し・チームの集中購入シーンでも低レイテンシと高可用性を維持します。残高課金、組み合わせサブスクリプション、初回チャージ特典、企業向け請求書発行、専属 1v1 サポートにも対応しており、個人の頻繁な利用にも企業の長期導入にも適しています。今 Unity2.ai に登録すると $2 の残高、公式グループに参加するとさらに $10 の残高がもらえ、合計最大 $12 の無料クレジットを獲得できます — 試用後に長期利用したい方に最適です。登録リンク
veilx Veilx のご支援に感謝します!Veilx CDN は超大規模 API リクエストシナリオ向けに設計されており、AI 中継サービスと AI API 呼び出しチェーンに対して深く最適化されています。高並列・高頻度リクエスト・大容量トラフィックに容易に対応し、開発者と企業により高速で安定した、低レイテンシの加速体験を提供します。OpenAI、Claude、Gemini などの AI インターフェース中継はもちろん、チャット、画像生成、Embedding、ストリーミング出力などの複雑なシナリオでも、Veilx は応答速度と接続安定性を大幅に向上させ、ネットワーク変動によるタイムアウトや失敗を効果的に削減します。さらに、Veilx は中国三大ネットワーク最適化の高速回線を提供しており、中国本土から海外 AI サービスへのアクセス速度と安定性を大幅に向上させます。グローバル AI 中継プラットフォーム、海外 AI SaaS、越境ビジネス、高並列 API システム展開に特に適しています。AI API のために生まれ、あなたの AI 中継サービスをより速く、より安定して、より安心に。購入リンク
RoxyBrowser RoxyBrowser のご支援に感謝します!RoxyBrowser は Sub2API の理想的なパートナーです:ネイティブ統合された Roxy AI Agent と高品質なネイティブ住宅 IP を搭載し、シンプルなコマンドで一括自動化をサポート、マルチアカウント管理のセキュリティと効率を大幅に向上させます!このリンクから登録すると、無料の住宅 IP パッケージと生涯 10% 割引を獲得できます。
apikl Apikl のご支援に感謝します!Sub2API をベースに構築された本プラットフォームは、開発者向けに Codex / Claude シリーズモデルの中継サービスを提供しています。長期安定性、高速直結、高いコストパフォーマンスを重視し、従量課金の残高ベース課金、エンタープライズグレードの正規請求書、1対1の専属サポートを提供します。今すぐ登録でチャージ 1:1 ボーナス — 残高が倍に!
tokeneum TokenEum のご支援に感謝します!TokenEum は総合的な AI モデル集約プラットフォームおよびインテリジェントエージェント開発企業です。Claude、Gemini、OpenAI などの世界トップクラスのモデルに加え、GLM、Qwen、Kimi などの主要なオープンソースモデルも集約しており、品質と価格の異なる豊富な選択肢を提供してあらゆるニーズに対応します。また、Seedance2.0 や Happy Horse などの最先端の動画生成モデルも利用可能です。TokenEum は透明性と誠実なビジネスを重視し、すべてのモデル情報の正確性と信頼性を保証します。tokeneum.ai でぜひお試しください。
666api 666api のご支援に感謝します!666api はオールインワンプラットフォームで、以下を提供しています:⚡ API 中継 — グローバルモデルへの従量課金アクセス、100% 公式ソースから直接供給、公式価格の最大 75% オフ。独占特典:Zhipu GLM 50% オフ・DeepSeek V4-pro 50% オフ・Seedance2.0 8% オフ(ホワイトリスト)・HappyHorse Overseas 30% オフ(ホワイトリスト)🔑 GPT サブスクリプションアカウント — 同源 IP 込み・グローバル住宅 IP 💰 請求書発行対応
BytePlus Dola seed のご支援に感謝します!Dola Seed 2.0 は、ByteDance がグローバル市場向けに独自開発した全モーダル汎用大規模モデルです。統一されたマルチモーダルアーキテクチャに基づき、テキスト・画像・音声・動画の共同理解と生成をサポートします。エージェント協調をネイティブに有効化し、強力な推論・長期タスク実行・ツール統合・コーディング能力を備えています。スマートコックピット、パーソナルアシスタント、教育、カスタマーサポート、マーケティング、リテールなど多様なシナリオに広く適用可能です。マルチモーダル知覚、エンドツーエンドの複雑タスク配信、安定したインタラクション、データセキュリティに優れ、ModelArk プラットフォームを通じて容易にアクセス・デプロイできます。こちらのリンクから登録すると、各モデルにつき 50 万トークンの無料推論クォータを獲得できます。 >>中国大陸地域の開発者はこちらをクリック
sui-xiang 随想AI ゲートウェイのご支援に感謝します!随想AI ゲートウェイ は信頼性と効率に優れた API 中継サービスプロバイダーで、Claude、Codex、Gemini などの中継サービスを提供しています。プライバシー重視の中継ステーション・データ転売なし・モデル水増しなし、プライバシー・透明性・超高速アフターサービス。新規アカウント登録後、毎日サインインで 0.5 元のテストクレジットがもらえ、チャージは 1:1、サブスクリプション不要、従量課金。マルチライン冗長、クロスリージョン災害復旧、自動フェイルオーバー、長時間 SSE 接続が途切れません。99.9% の可用性、重要な呼び出しは決して遅れません。
miyaip MiyaIP のご支援に感謝します!MiyaIP はグローバル住宅プロキシネットワークサービスに特化したプラットフォームで、企業開発者、越境ビジネスチーム、AI アプリケーションユーザーに高品質で純粋な海外住宅 IP リソースを提供することに注力しています。AI プラットフォーム、海外 SaaS、その他のオンラインサービスに安定した独立した海外ネットワーク環境を提供し、複数地域でのアクセステストやプロジェクト環境の分離をサポートします。海外 AI サービスへのアクセスが必要な開発・テストシナリオに最適です。例:AI モデルプラットフォームアクセス、AI 開発テスト、AI SaaS サービス利用、AI API デバッグ、複数地域のネットワーク環境検証など。
anpin anpin.ai のご支援に感謝します!anpin.ai は AI の普及推進に取り組むハイエンド AI 中継サービスプラットフォームです。先進的な技術アーキテクチャとグローバル分散デプロイメントにより、国際トップクラスの大規模モデルへの高速直通ルートを提供します。 自社構築の一次アカウントプール:1-3秒の超高速応答、同業者への配布に対応 極めて高い安定性:マルチライン・インテリジェントルーティング + 冗長バックアップシステムにより、年中無休の高可用性運用を確保; モデルの真正性:一切のコンテンツ介入や二次フィルタリングを行わず、最も純粋で強力なネイティブモデル能力を体験できます。 チャージ 1:1、エンタープライズグレードサービスは請求書発行可能。安品 AI は単なる中継所ではなく、最先端のインテリジェント世界へと繋がる安全・信頼性・高効率の橋渡し役です。
proxy4free Proxy4Free は開発者と AI アプリケーション向けのデータプロキシサービスプロバイダーで、住宅プロキシ、静的住宅プロキシ、ISP プロキシ、データセンタープロキシなど多様なプロキシソリューションを提供しており、Web Scraping、Browser Automation、AI Agent などのシナリオに適しています。グローバル IP リソース、安定した接続、柔軟な切り替えをサポートし、開発者のデータ収集成功率の向上と IP ブロックリスクの低減を支援します。こちらのリンクから登録して、より安定した効率的な自動化ワークフローを簡単に構築しましょう。

概要

Sub2API は、AI 製品のサブスクリプションから API クォータを配分・管理するために設計された AI API ゲートウェイプラットフォームです。ユーザーはプラットフォームが生成した API キーを通じて上流の AI サービスにアクセスでき、プラットフォームは認証、課金、負荷分散、リクエスト転送を処理します。

機能

  • マルチアカウント管理 - 複数の上流アカウントタイプ(OAuth、APIキー)をサポート
  • APIキー配布 - ユーザー向けの APIキーの生成と管理
  • 精密な課金 - トークンレベルの使用量追跡とコスト計算
  • スマートスケジューリング - スティッキーセッション付きのインテリジェントなアカウント選択
  • 同時実行制御 - ユーザーごと・アカウントごとの同時実行数制限
  • レート制限 - 設定可能なリクエスト数およびトークンレート制限
  • 内蔵決済システム - EasyPay、Alipay、WeChat Pay、Stripe に対応。ユーザーのセルフサービスチャージが可能で、別途決済サービスのデプロイは不要(設定ガイド
  • 管理ダッシュボード - 監視・管理のための Web インターフェース
  • 外部システム連携 - 外部システム(チケット管理など)を iframe 経由で管理ダッシュボードに埋め込み可能

エコシステム

Sub2API を拡張・統合するコミュニティプロジェクト:

プロジェクト 説明 機能
~~Sub2ApiPay~~ ~~セルフサービス決済システム~~ 内蔵済み — 決済機能は Sub2API に統合されました。別途デプロイは不要です。決済設定ガイドをご参照ください
sub2api-mobile モバイル管理コンソール ユーザー管理、アカウント管理、監視ダッシュボード、マルチバックエンド切り替えが可能なクロスプラットフォームアプリ(iOS/Android/Web)。Expo + React Native で構築

技術スタック

コンポーネント 技術
バックエンド Go 1.25.7, Gin, Ent
フロントエンド Vue 3.4+, Vite 5+, TailwindCSS
データベース PostgreSQL 15+
キャッシュ/キュー Redis 7+

Nginx リバースプロキシに関する注意

Sub2API(または CRS)を Nginx でリバースプロキシし、Codex CLI と組み合わせて使用する場合、Nginx の http ブロックに以下の設定を追加してください:

underscores_in_headers on;

Nginx はデフォルトでアンダースコアを含むヘッダー(例: session_id)を破棄するため、マルチアカウント構成でのスティッキーセッションルーティングに支障をきたします。


デプロイ

方法1: スクリプトによるインストール(推奨)

GitHub Releases からビルド済みバイナリをダウンロードするワンクリックインストールスクリプトです。

前提条件

  • Linux サーバー(amd64 または arm64)
  • PostgreSQL 15+(インストール済みかつ稼働中)
  • Redis 7+(インストール済みかつ稼働中)
  • root 権限

インストール手順

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

スクリプトは以下を実行します: 1. システムアーキテクチャの検出 2. 最新リリースのダウンロード 3. バイナリを /opt/sub2api にインストール 4. systemd サービスの作成 5. システムユーザーと権限の設定

インストール後の作業

# 1. サービスを起動
sudo systemctl start sub2api

# 2. 起動時の自動起動を有効化
sudo systemctl enable sub2api

# 3. ブラウザでセットアップウィザードを開く
# http://YOUR_SERVER_IP:8080

セットアップウィザードでは以下の設定を行います: - データベース設定 - Redis 設定 - 管理者アカウントの作成

アップグレード

管理ダッシュボードの左上にあるアップデートを確認ボタンをクリックすることで、ダッシュボードから直接アップグレードできます。

Web インターフェースでは以下が可能です: - 新しいバージョンの自動確認 - ワンクリックでのアップデートのダウンロードと適用 - 必要に応じたロールバック

よく使うコマンド

```bash

ステータスを確認

sudo systemc

Extension points exported contracts — how you extend this code

Rollbacker (Interface)
Rollbacker is the interface that wraps the Rollback method. [6 implementers]
backend/ent/tx.go
RefreshTokenCache (Interface)
RefreshTokenCache 管理Refresh Token的Redis缓存 用于JWT Token刷新机制,支持Token轮转和防重放攻击 Key 格式: - refresh_token:{token_hash} -> R [6 …
backend/internal/service/refresh_token_cache.go
ApiErrorLike (Interface)
* Centralized API error message extraction * * The API client interceptor rejects with a plain object: { status, code,
frontend/src/utils/apiError.ts
Committer (Interface)
Committer is the interface that wraps the Commit method. [3 implementers]
backend/ent/tx.go
GeminiOAuthClient (Interface)
GeminiOAuthClient performs Google OAuth token exchange/refresh for Gemini integration. [17 implementers]
backend/internal/service/gemini_oauth.go
ImportMetaEnv (Interface)
(no doc)
frontend/src/vite-env.d.ts
OrderFunc (FuncType)
OrderFunc applies an ordering on the sql selector. Deprecated: Use Asc/Desc functions or the package builders instead.
backend/ent/ent.go
HTTPUpstream (Interface)
HTTPUpstream 上游 HTTP 请求接口 用于向上游 API(Claude、OpenAI、Gemini 等)发送请求 [15 implementers]
backend/internal/service/http_upstream_port.go

Core symbols most depended-on inside this repo

Set
called by 2321
backend/internal/service/setting_service.go
Error
called by 2217
backend/ent/enttest/enttest.go
String
called by 1957
backend/internal/service/usage_log.go
Get
called by 1682
backend/internal/service/setting_service.go
WriteString
called by 1584
backend/internal/handler/ops_error_logger.go
Run
called by 1475
backend/internal/handler/admin/channel_monitor_handler.go
Add
called by 1458
backend/internal/handler/admin/account_codex_import.go
SetField
called by 1295
backend/ent/mutation.go

Shape

Method 24,649
Function 17,553
Struct 2,841
Interface 673
FuncType 236
TypeAlias 97
Class 8

Languages

Go96%
TypeScript4%
Python1%

Modules by API surface

backend/ent/mutation.go4,039 symbols
backend/ent/client.go750 symbols
backend/ent/paymentorder/where.go491 symbols
backend/ent/usagelog_create.go468 symbols
backend/ent/usagelog/where.go451 symbols
backend/ent/group_create.go426 symbols
backend/ent/paymentorder_create.go412 symbols
backend/ent/account_create.go349 symbols
backend/ent/group/where.go345 symbols
backend/ent/account/where.go334 symbols
backend/internal/service/gateway_service.go330 symbols
backend/ent/user/where.go297 symbols

Dependencies from manifests, versioned

ariga.io/atlasv0.32.1-0.2025032510 · 1×
dario.cat/mergov1.0.2 · 1×
entgo.io/entv0.14.5 · 1×
github.com/Azure/go-ansitermv0.0.0-2021061722524 · 1×
github.com/DATA-DOG/go-sqlmockv1.5.2 · 1×
github.com/Microsoft/go-winiov0.6.2 · 1×
github.com/agext/levenshteinv1.2.3 · 1×
github.com/alicebob/miniredis/v2v2.38.0 · 1×
github.com/alitto/pond/v2v2.6.2 · 1×
github.com/andybalholm/brotliv1.2.0 · 1×
github.com/apparentlymart/go-textseg/v15v15.0.0 · 1×
github.com/aws/aws-sdk-go-v2v1.41.3 · 1×

Datastores touched

sub2apiDatabase · 1 repos

For agents

$ claude mcp add sub2api \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact