whatisgithub

What is one-api?

jrdw0/one-api — explained in plain English

Analysis updated 2026-07-14 · repo last pushed 2023-12-28

Audience · ops devopsComplexity · 3/5DormantLicenseSetup · easy

In one sentence

One API is a self-hosted gateway that unifies multiple AI model providers, like OpenAI, Claude, and Gemini, behind a single consistent interface so you can manage access keys, track usage, and control spending for your team or customers.

Mindmap

mindmap
  root((repo))
    What it does
      Unifies multiple AI providers
      Translates requests between formats
      Tracks spending per user
    Key features
      Load balancing across providers
      Automatic retries on failure
      Spending limits and user groups
      Redemption codes for top-ups
    Deployment
      Single file executable
      Ready-to-use Docker image
      Multi-server for high traffic
    Customization
      Web interface with branding
      User login and access keys
      Configurable channels
    Use cases
      Startup team access control
      Agency reselling AI access
      Personal AI gateway
    License
      MIT open source
      Keep credit link in footer
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give your development team access to multiple AI models without exposing original API credentials.

USE CASE 2

Resell AI access to clients with separate keys, usage tracking, and spending limits per client.

USE CASE 3

Manage your own personal collection of AI tools from one central dashboard.

USE CASE 4

Set up a multi-server AI gateway to handle high traffic across different model providers.

What is it built with?

GoDockerSQLiteMySQLRedis

How does it compare?

jrdw0/one-api0xhassaan/nn-from-scratch0xzgbot/hermes-comfyui-skills
Stars00
LanguagePython
Last pushed2023-12-28
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity3/54/51/5
Audienceops devopsdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Ships as a single executable or Docker image so you can get running with one command, but you need API keys from at least one AI provider.

Use freely for any purpose, including commercial use, as long as you keep a credit link in the footer unless you get permission to remove it.

So what is it?

One API lets you bring all your AI models under one roof. Instead of juggling separate API keys and setup instructions for OpenAI, Anthropic Claude, Google Gemini, and a dozen Chinese AI services, you connect them all to a single hub. You then hand out your own access keys to your team or customers, and everyone can use any of those models through a single, consistent interface. The system acts as a smart middleman between your users and the AI providers. You plug in your original API keys from the various services, and the hub translates requests so they work with whichever model you want to use. It handles load balancing across providers, can automatically retry if a service fails, and tracks how much each user or token is spending. You can set spending limits, create user groups with different pricing rates, and even generate redemption codes for account top-ups. This is built for teams and businesses that rely on multiple AI models and need to manage who can use what. A startup offering an AI-powered product could use it to give their developers access to different models without exposing the original credentials. An agency reselling AI access could use it to create separate keys for each client, track their usage, and control how much they can spend. It also works as a personal gateway if you use several AI tools yourself and want one place to manage them all. The project is notable for being extremely easy to deploy. It comes as a single file or a ready-to-use Docker image, so you can get it running with one command. It supports multi-server setups for handling high traffic, and it offers a customizable web interface where you can add your own branding, set up user login, and configure channels. The code is open source under an MIT license, with the only condition being that you keep a credit link in the footer unless you get permission to remove it.

Copy-paste prompts

Prompt 1
Help me deploy One API using Docker and connect my OpenAI and Anthropic API keys so my team can access both through a single gateway.
Prompt 2
I want to set up spending limits and user groups in One API so different clients get different pricing rates. Walk me through the configuration steps.
Prompt 3
Show me how to configure load balancing and automatic retries in One API so requests fall back to another provider when one fails.
Prompt 4
Help me customize the One API web interface with my own branding and set up user login for my team members.
Prompt 5
I have One API running for a single provider. Guide me through adding channels for Google Gemini and a Chinese AI service so all models are available through one endpoint.

Frequently asked questions

What is one-api?

One API is a self-hosted gateway that unifies multiple AI model providers, like OpenAI, Claude, and Gemini, behind a single consistent interface so you can manage access keys, track usage, and control spending for your team or customers.

Is one-api actively maintained?

Dormant — no commits in 2+ years (last push 2023-12-28).

What license does one-api use?

Use freely for any purpose, including commercial use, as long as you keep a credit link in the footer unless you get permission to remove it.

How hard is one-api to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is one-api for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.