free-ai Admin

Configure base URL + admin token

Connection stored in localStorage

Health

Status
—

Providers

ID Name Base Links
No data
Add / upsert provider (POST /admin/providers)

Backend may not implement this yet — errors are shown as-is.

Semi-auto register wizard

Numbered flow: pick provider → open signup/key pages → paste key → import → optional chat test. Full keys are never shown. CLI: ./tools/onboard.sh wizard [provider_id]

1

Provider info

2

Open signup / key URLs

Create a free account on the provider site, then copy an API key.

3

Paste API key

4

Import key

POST /admin/keys — stores encrypted vault entry only.

5

Chat test

Uses GATEWAY_TOKEN + model auto (or provider model). Prints OK / FAIL only.

$ ./tools/onboard.sh wizard <provider_id>

Keys

ID Provider Label Hint Status
No data

Add key

Models

Provider Model Ctx RPM / RPD
No data

Catalog

Seed writes the built-in provider/model list. Sync pulls CATALOG_SOURCE_URL. 


      


      
      

        

          Usage
          
            
          
        

        
GET /admin/usage?days=7 — last 7 days (UTC).

        

          
Requests
—

          
Tokens est.
—

          
429 errors
—

        

        

          

            
Requests / day

            

          

          

            
Tokens est. / day

            

          

        

        

          
Per key (window)

          

            

              
                
KeyProviderReqTokens429

              
              
                
Not loaded

              
            

          

        

        
        
      

    


    
    

      
Test chat POST /v1/chat/completions

      

        

          
          
          
        

        

          
          
        

      

      

        
Send a message to test the gateway.