OpenRouter BYOK in Greta

Document Type: Official Status: Active Last Updated: 05/01/26

Overview

This document provides an official explanation of OpenRouter and its integration with Greta, including what OpenRouter is, how to connect it, how it works, and how billing and credits behave when OpenRouter is enabled or disabled.

This documentation is intended for all Greta users, including Enterprise and Non-Enterprise customers.

What Is OpenRouter

OpenRouter is a unified AI routing platform that allows access to multiple Large Language Models (LLMs) through a single API key.

Instead of integrating individual AI providers separately, Greta integrates with OpenRouter as a single gateway for all AI model requests.

OpenRouter BYOK (Bring Your Own Key)

OpenRouter BYOK allows users to connect their own OpenRouter API key to Greta.

When BYOK is enabled:

  • Greta uses OpenRouter to make all AI API calls

  • AI usage is billed directly on the user’s OpenRouter account

  • Greta credits are not used

Availability & Eligibility

Enterprise Users

  • OpenRouter BYOK is available for free

  • No additional purchase is required

  • Users can directly connect their OpenRouter API key

Non-Enterprise Users

  • OpenRouter BYOK must be enabled by purchasing an add-on

  • A $5 OpenRouter add-on is deducted every month to keep OpenRouter (BYOK) active.

  • In addition to the monthly deduction, a minimum Greta credit balance is required for API calls to work. This fee only enables the integration

  • Model usage costs are handled separately by OpenRouter

How to Connect OpenRouter in Greta

Step 1: Open Integrations

  1. Open Greta

  2. Navigate to Settings from the left-hand menu

  3. Click on the Integrations tab

Step 2: Enable OpenRouter

For Enterprise Users

  • OpenRouter will be available by default

  • Click Connect to proceed

For Non-Enterprise Users

  1. You will see a message indicating that OpenRouter is not enabled

  2. Click Subscribe

  3. You will be redirected to the Plans & Pricing page

  4. Select “Power your AI with OpenRouter – $5 Add-on”

  5. Complete the payment using your card

  6. Once payment is successful, OpenRouter will be enabled

Step 3: Connect OpenRouter API Key

  1. Return to Settings → Integrations

  2. Click Connect under OpenRouter

  3. Enter your OpenRouter API key

  4. Click Save

You will see the confirmation message:

“OpenRouter API key saved successfully.”

This confirms that the connection is active.

How OpenRouter Works in Greta

Greta determines whether to use OpenRouter or Greta credits based on the “Always use this key” setting in the Integrations section.

“Always use this key” — ON

When Always use this key is turned ON:

  • OpenRouter is always used for all AI API calls

  • Greta routes every request through the connected OpenRouter API key

  • Greta credits are never consumed

  • Billing happens entirely on the user’s OpenRouter account

This mode ensures full BYOK behavior with no fallback to Greta credits.

“Always use this key” — OFF

When Always use this key is turned OFF:

  • OpenRouter is used only when it is explicitly enabled

  • If OpenRouter is disabled or disconnected, Greta automatically falls back to its default AI setup

  • Greta credits are consumed when fallback occurs

In simple terms:

OpenRouter is used only when the key is enabled. If it’s not enabled, Greta falls back to its own credits.

Model Usage & Billing

  • Greta does not charge per token or per request when BYOK is active

  • OpenRouter handles all usage-based billing

  • Users have full visibility and control over spend via OpenRouter

Managing OpenRouter Connection

  • OpenRouter can be disconnected at any time from the Integrations tab

  • Users can re-enable it later using the same steps

  • Switching OpenRouter off will revert usage back to Greta’s default billing and credits

Working on Projects with OpenRouter

After enabling OpenRouter BYOK:

  • Users can open any existing or new project

  • Continue building without changing workflows

  • No credits will be deducted for AI usage

  • Everything runs using the connected OpenRouter API key

Tutorial Video

For a step-by-step visual walkthrough on enabling and using OpenRouter BYOK in Greta, watch the official tutorial:

▶ OpenRouter BYOK in Greta – Tutorial

Summary

OpenRouter integration in Greta provides flexible and predictable behavior:

  • OpenRouter is used only when the API key is enabled

  • With Always use this key ON, OpenRouter is always used and Greta credits are never consumed

  • With Always use this key OFF, Greta automatically falls back to its own AI and credits

  • Billing is handled either by OpenRouter or Greta based on the active configuration

This ensures reliability, cost control, and seamless fallback for all users.

PreviousGreta Framework & Library Support PolicyNextGreta Recipies

Last updated