Quick Start
This guide will help you set up Liona and start using it in minutes. By the end, you’ll have a fully functional project with connected AI providers, policies, and the ability to generate access keys.
Create your first project
Projects in Liona help you organize users, providers, and policies into logical groups.
- After signing in, click the project selector at the top left of the dashboard
- Click “New Project”
- Select an Organization.
- Enter a name for your project (e.g., “Production”, “Internal Team”, or “Development”)
- Click “Create Project”
Consider creating separate projects for different environments (development, testing, production) or different user groups (employees, customers).
Connect an AI provider
Next, connect one or more AI providers to make their capabilities available through Liona.
- Click “AI Providers” in the left sidebar
- Click “New AI Provider”
- Select your provider (e.g., OpenAI, Anthropic, Grok, Gemini)
- Enter your API key from that provider
- Click “Save Provider”
We recommend creating a dedicated API key for Liona at each provider to maintain clean separation and enable easy rotation if needed.
Create a usage policy
Policies control how much your users can spend and which features they can access.
- Click “Policies” in the left sidebar
- Click “New Policy”
- Enter a policy name (e.g., “Default”, “Pro Tier”, or “Marketing Team”)
- Set appropriate limits:
- Monthly spend limit
- Daily spend limit
- Hourly spend limit
- Optionally enable Pro features:
- Request Tracing
- Request Caching
- Click “Create Policy”
Add a user
Users represent individuals or systems that will access your AI providers through Liona.
- Click “Users” in the left sidebar
- Click “New User”
- Enter:
- User ID (a unique identifier you use internally)
- Email (optional, for easier identification)
- Select the policy you created earlier
- Click “Create User”
Generate an access key
Access keys allow your users to authenticate with Liona when making AI requests.
- Click the user you just created
- Click “Create Key”
- Optionally set an expiration date
- Click “Create Access Key”
- Copy the generated key
Start using Liona
With everything set up, you can now start using Liona in your applications or share access with team members.
For developers integrating AI into applications:
Use your access key with native AI SDKs:
import OpenAI from 'openai';
const openai = new OpenAI({
apiKey: 'liona_access_key_here', // Your Liona access key
baseURL: 'https://api.liona.ai/v1/provider/openai', // Only needed for self-hosted Liona
});
const completion = await openai.chat.completions.create({
model: 'gpt-4',
messages: [{ role: 'user', content: 'Hello, AI!' }],
});
For team administrators:
Share the access key with team members and instruct them to use it in place of the original provider API key in their tools.
What’s Next?
Now that you have Liona up and running, you might want to:
- Learn about advanced provider balancing
- Create more granular policies
- Set up request tracing for debugging
For detailed tutorials on connecting specific AI SDKs, check our SDK integration guides.