Skip to Content

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.

Creating a new project in Liona

  1. After signing in, click the project selector at the top left of the dashboard
  2. Click “New Project”
  3. Select an Organization.
  4. Enter a name for your project (e.g., “Production”, “Internal Team”, or “Development”)
  5. Click “Create Project”
💡
Tip

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.

Adding an AI provider

  1. Click “AI Providers” in the left sidebar
  2. Click “New AI Provider”
  3. Select your provider (e.g., OpenAI, Anthropic, Grok, Gemini)
  4. Enter your API key from that provider
  5. Click “Save Provider”
Note

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.

Creating a usage policy

  1. Click “Policies” in the left sidebar
  2. Click “New Policy”
  3. Enter a policy name (e.g., “Default”, “Pro Tier”, or “Marketing Team”)
  4. Set appropriate limits:
  • Monthly spend limit
  • Daily spend limit
  • Hourly spend limit
  1. Optionally enable Pro features:
  • Request Tracing
  • Request Caching
  1. Click “Create Policy”

Add a user

Users represent individuals or systems that will access your AI providers through Liona.

Adding a user

  1. Click “Users” in the left sidebar
  2. Click “New User”
  3. Enter:
  • User ID (a unique identifier you use internally)
  • Email (optional, for easier identification)
  • Select the policy you created earlier
  1. Click “Create User”

Generate an access key

Access keys allow your users to authenticate with Liona when making AI requests.

Generating an access key

  1. Click the user you just created
  2. Click “Create Key”
  3. Optionally set an expiration date
  4. Click “Create Access Key”
  5. 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:

For detailed tutorials on connecting specific AI SDKs, check our SDK integration guides.

Last updated on