mrkeyoor.com_
Tue 03 Nov 04:53 UTC
AI Toolsevaluationupdated 01 Nov 2026

sub2api review

Choose Sub2API for an authorized pool of upstream AI accounts when you need user keys, billing and account scheduling. Its README warns that use may violate upstream providers' terms. Sub2API is a Go gateway for distributing subscription quotas and API access; our run checked repository commands, not a working subscription relay.

+294stars / 7d
Verdict

Sub2API warrants an evaluation when you have authorized upstream accounts and need its billing, user-key and scheduling functions. Our September 28, 2026 run at commit 9a62841 records successful repository commands, with package-level parser summaries rather than verified individual-test counts. Before adoption, test your exact client and provider path in a private deployment, confirm upstream permission and verify backup recovery. Use a direct integration or another gateway when account pooling does not justify the operating work.

We ran it

Lab card: what happened when we ran sub2apiScreenshot of sub2api (github.com/Wei-Shaw/sub2api)
Install✓ · 85s409 packages
Build✓ · 237s
Tests✓ · 268s104 passed · 0 failed of 104 (go test)
Repo4139 files~1,375,345 lines of source · 54.5 MB · 4 CI workflows · Dockerfile

Answers from our run

Does sub2api build from source?

Dependencies installed in 85 seconds (409 packages), and the build succeeded in 237 seconds. We cloned commit 9a62841 into a clean Debian container with 3 CPUs and no project-specific setup.

Do sub2api's tests pass?

Yes. The project's own test command finished in 268 seconds and reported 104 passed, 0 failed (go test).

Who should not use sub2api?

Anyone treating a successful build as permission to share or resell subscription access.

What are the alternatives to sub2api?

LiteLLM, New API. Sub2API warrants an evaluation when you have authorized upstream accounts and need its billing, user-key and scheduling functions.

Setup3/5Repository commands succeeded, but PostgreSQL, Redis, secrets and first-admin setup leave material deployment work; see the visible rubric.
Docs4/5Deployment and network guidance is detailed, but the source configuration-copy step must be read alongside the later admin-account warning; see the visible rubric.
CommunityN/AThe supplied independent extracts do not establish maintainer response times, contributor continuity or support outcomes.
Maturity3/5The recorded 0.2.9 repository commands succeeded, while deployed operation, live providers and upgrades remain untested here; see the visible rubric.

Who it’s for

Platform operators who have permission to share the upstream accounts they connect.
Teams that need centrally issued keys, token accounting, account selection and concurrency limits.
Self-hosters prepared to operate PostgreSQL, Redis and a gateway holding provider credentials.

Who it’s NOT for

Anyone treating a successful build as permission to share or resell subscription access.
Teams that need demonstrated live-provider compatibility or load-test results before adoption; our run provides neither.
Applications whose direct provider integration already meets their needs.
Operators who cannot maintain database backups, secrets and reverse-proxy configuration.

Setup reality

Our run on September 28, 2026 used commit 9a62841 in our sandbox. The attached harness records successful install, build and test steps at 85, 237 and 268 seconds respectively, each with exit code 0 and no timeout. It reports 409 dependencies.

The stored parser summaries report 104 passed, 0 failed and 104 total; the raw measurement labels these as Go package outcomes and separately records 57 packages without tests. These are not verified counts of unique individual tests.

The sandbox image was golang:1.24-bookworm with 3 CPUs and 8 GB of memory, but the install tail records downloading Go 1.27.0. The image label therefore does not establish that Go 1.24 compiled the project. A deployed gateway still needs PostgreSQL 15+, Redis 7+, an administrator and upstream credentials.

Should you use Sub2API?

Choose Sub2API for an authorized pool of upstream AI accounts when you need user keys, billing and account scheduling. Its README warns that use may violate upstream providers' terms. Confirm permission for the account types and sharing arrangement before importing credentials. Passing repository checks cannot resolve that permission question.

The README at the measured commit describes OAuth and API-key accounts, platform-issued user keys, token accounting, sticky sessions and per-user and per-account concurrency limits. Those features address the work of operating an account pool. They also introduce a database, cache and administrative service that a direct provider integration may not need.

What our September 28 run establishes

Our run on September 28, 2026 used commit 9a62841 in our sandbox. The full recorded commit is 9a62841fd124d026cf3694fcf9b79e98addcdbdc. The attached harness records the install step at 85 seconds, build at 237 seconds and tests at 268 seconds. Each step returned exit code 0 without timing out; the build tail ends with vet-exit:0.

The stored parser summaries report 104 passed, 0 failed and 104 total. The matching raw record calls these package outcomes: packagesOk is 104 and packagesFail is 0, with 57 packages recorded separately as having no tests. The retained output also includes a package marked [no tests to run]. These summaries do not establish exhaustive, unique individual-test coverage, and we have not reconciled complete logs or performed a new execution.

The sandbox had 3 CPUs, 8 GB of memory and the golang:1.24-bookworm image. Its install tail says go: downloading go1.27.0 (linux/amd64), so describing the run simply as a Go 1.24 test would be misleading.

Our harness records command status, exit code, elapsed time, timeout status and parsed outcomes separately. The testing methodology explains that distinction and the limits of sandbox testing. That page describes the publisher's methodology today; it does not establish which methodology revision governed this September run.

The supplied record does not demonstrate a deployed gateway, successful CLI integration, live OAuth refresh, payment processing, upstream account scheduling or sustained traffic. Audit data is absent, and dependency scan coverage is unknown. The command results support a repository evaluation, not a security or production-readiness finding.

Deployment adds work beyond the green commands

The measured commit's README requires PostgreSQL 15+ and Redis 7+. Its Compose deployment includes both services; its binary installer requires root and already running database and Redis services. Neither deployment path was exercised by our recorded command outcomes.

Source builders should read the first-admin warning before following the configuration-copy step. The README says an existing configuration skips the setup wizard, while the historical admin fields in that configuration do not create the initial administrator. Follow the documented wizard procedure rather than assuming those fields provision a login.

The same README documents legacy forwarded-header trust enabled for upgrade compatibility. It tells operators to restrict origin access to their proxies and have the edge overwrite trusted client-IP headers. It also warns that disabling URL allowlist validation permits HTTP upstream URLs by default. Review proxy trust, require HTTPS upstream traffic and restrict outbound destinations before exposing a deployment.

The measured commit changes the version to 0.2.9. The separately supplied 0.2.10 release is not the version tested here. Current README instructions should also be checked against the version you actually deploy.

When another gateway fits better

LiteLLM supports direct Python SDK integration as well as a centralized proxy server. Its README makes it a candidate when you need a common interface across provider APIs, either inside an application or behind a team gateway. That is an alternative integration approach; this review does not establish equivalent subscription-account behavior or comparative performance.

New API manages upstream model services through a consistent client API and a web console. Its README makes it a candidate when channel configuration, usage accounting and protocol conversion are the main requirements. It warns that conversion features depend on the upstream model and conversion path, and it also requires authorized upstream access. Switching gateways does not remove provider obligations.

These are replacement candidates for the gateway role, not required companions to Sub2API. We did not run either alternative for this correction.

How the ratings should be read

These are editorial assessments, not benchmark results. For each assessed dimension, 1 means substantial documented obstacles, 2 means several unresolved obstacles, 3 means workable with material operating work or validation gaps, 4 means strong documented support with remaining limits, and 5 requires broader corroboration than this record provides. An unassessed dimension means the necessary evidence is missing.

Setup ease is 3/5: repository commands succeeded, but deploying the service requires PostgreSQL, Redis, secrets and careful first boot. Documentation is 4/5: the README covers deployment and concrete network settings, although its configuration-copy procedure needs the later administrator warning to avoid a failed first login. Maturity is 3/5: the recorded 0.2.9 commands succeeded, but live operation and upgrade behavior remain untested here. Community is unassessed because the supplied independent extracts do not establish response times, contributor continuity or support outcomes.

Alternatives

ProjectWhat it isPick it when
LiteLLM gh↗A common provider interface available as a Python SDK or centralized proxy.Evaluate it when direct Python integration or a shared provider-API gateway is the requirement; equivalent subscription-account handling was not established here.
New API gh↗A self-hosted gateway with channel routing, usage accounting and a web console.Evaluate it when managing authorized upstream services and protocol conversion is the main job; verify the exact conversion path because capabilities depend on the channel and model.

What people are saying

  1. [github-trending] Wei-Shaw/sub2api

Sources

  1. Sub2API README
  2. Measured Sub2API commit 9a62841
  3. Sub2API 0.2.10 release
  4. Sub2API open issues
  5. Sub2API open pull requests

More ai tools reviews

kornia · skills · anarlog · pr-agent · agent-sprite-forge · KiroCrew · the whole board →