Skip to main content

​
What AI Gateway is

AI Gateway is the Partner Portal’s top-level menu for creating metered LLM API keys. It is designed as an OpenAI-compatible gateway, so partners can use the standard OpenAI SDK pattern and swap the base_url to https://api.knotie.ai. Use AI Gateway when you want to:
  • Create partner-owned virtual LLM keys
  • Restrict each key to specific models
  • Pre-fund usage from Knotie Credits
  • Assign a key to a customer and bill usage back to that customer’s AI Credits
  • Let customers create their own AI Gateway keys from the whitelabel portal

​
Where to find it

In the Partner Portal sidebar:
  1. Open AI Gateway.
  2. Use the top section for the SDK quick start.
  3. Use AI Gateway Keys to create and manage keys.
  4. Use Customer Self-Service API Keys to control client-portal access.
Partner AI Gateway overview

​
Quick start section

The page includes a built-in quick start with example snippets for:
  • Python
  • Node.js
  • cURL
All examples use:
  • Your generated virtual key
  • https://api.knotie.ai as the gateway base URL

​
Create a partner AI Gateway key

Click Create Key to open the partner key modal. The modal supports:
  • Key Name
  • Description
  • Budget (Knotie Credits)
  • Allowed Models
  • Customer Billing (optional)
  • Enable Auto Top-Up
  • Allowed Domains (optional)
Budget behavior:
  • The partner key uses a pre-funded budget from your Knotie Credit balance.
  • 100 credits = $1.00 USD.
  • If your tier has an admin/platform fee, the modal shows the total credits required before creation.
Partner AI Gateway create key modal

​
Model access and plan limits

Available models are filtered by the partner’s subscription tier. The UI groups models into categories such as:
  • budget
  • mid tier
  • premium
You can select one or more models per key. If a model is not available for your plan tier, it is not offered for selection.

​
Customer billing inside a partner key

When you assign a key to a customer, the modal exposes customer-billing controls:
  • Assign to Customer
  • Profit Multiplier
  • Price per AI Credit (cents)
  • Min Cost Floor per 1M Tokens (optional)
  • Billing Preview
This is used when you want the partner to create and own the key, but charge usage back to a specific customer’s AI Credits with markup. Partner AI Gateway customer billing

​
Auto top-up and allowed domains

Optional advanced controls include:
  • Auto Top-Up
  • Trigger Threshold (USD)
  • Top-Up Amount (USD)
  • Allowed Domains
Use these when you want keys to refill automatically or only work from approved domains.

​
Managing existing keys

The AI Gateway Keys table shows:
  • Name
  • Key prefix
  • Budget vs spend
  • Allowed models
  • Status
  • Last used
Available actions for active keys:
  • Top Up
  • Regenerate
  • Revoke
Important behaviors:
  • Regenerating a key immediately invalidates the old key.
  • Revoking a key cannot be undone.
  • Revoking refunds the unused reserve back to the partner balance according to the key type.
  • You can optionally show revoked keys in the table.
Expanded rows also show more detail, including:
  • Credits reserved
  • Credits used
  • Credits remaining
  • Profit multiplier
  • Credit price
  • Rate limits
  • Expiry
  • Auto top-up configuration

​
Virtual key handling

When a new key is created or regenerated, the virtual key is shown once in a success banner. Copy it immediately. The app warns that it will not be shown again. Partner AI Gateway created key

​
Customer Self-Service API Keys

The lower section of the page controls whether customers can create their own AI Gateway keys from the whitelabel portal. The section includes:
  • Master enable/disable toggle
  • Apply to New Customers
  • Apply to Existing Customers
  • Default Profit Multiplier
  • AI Credit -> USD Cents Rate
Partner AI Gateway self-service settings

​
Deposit and suspension behavior

When customer self-service is enabled:
  • Each customer-created AI Gateway key reserves 1,000 Knotie Credits from the partner balance as a deposit.
  • That reserve is approximately $10.
  • If the partner balance drops below 1,000 credits, customer-created keys can be suspended until the partner tops up again.

​
What customers also need

Turning on the master self-service setting is not enough by itself. For a customer to actually see AI Gateway in their portal, all of these must be true:
  • The partner-level Customer Self-Service API Keys master toggle is enabled
  • The customer has AI Credits Enabled
  • The customer’s AI Gateway menu visibility toggle is enabled in Features & Add-ons
See Features, add-ons, and menu visibility for the per-customer toggle.

​
Accuracy notes

Important distinctions:
  • Partner-created keys use a configurable budget entered in the modal.
  • Customer-created keys are pay-as-you-go from the customer’s AI Credits and do not ask the customer to enter a budget.
  • API Keys in the customer portal are different from AI Gateway:
    • API Keys depend on API Access
    • AI Gateway depends on AI Credits plus the partner self-service settings