We use cookies to enhance your experience and measure how the site performs. Choose "Essential Only" to disable analytics. Read our Privacy Policy.

    Odeus Docs

    How to migrate to cost-based limits

    Move your BYOK workspace from per-model message limits to cost-based monthly spend limits.

    How to migrate to cost-based limits

    Move your BYOK workspace from per-model message limits to cost-based monthly spend limits.

    Cost-based limits cap usage by monthly spend instead of per-model message counts. They cap what each user and the workspace spend per month and pace usage with weekly and session limits, which message counts can't do. We recommend switching from request-based limits to cost-based limits for more granular control over usage.

    Here's what changes:

    • Before: you capped usage with per-model message limits (Max messages per user, per time window) on each model.
    • After: you cap usage by monthly spend across all models, with per-plan, group, and individual limits and a fallback model.

    Per-model message limits keep working alongside cost-based limits, so you can keep them as an extra guardrail.

    Set up cost-based limits

    1. Open usage settings

    Navigate to Usage and spend limits in your Workspace Settings.

    <img src="https://mintcdn.com/odeus-34/693vAVq7sYVcKiIR/images/usage_limit_migration1.png?fit=max&auto=format&n=693vAVq7sYVcKiIR&q=85&s=95cced2dcf97e9953f0baebc3b5903a4" alt="Workspace settings navigation with the Usage section selected" style={{borderRadius: '6px'}} width="2176" height="1196" data-path="images/usage_limit_migration1.png" />

    2. Set the workspace spend limit

    Set a monthly cap for the whole workspace.

    <img src="https://mintcdn.com/odeus-34/693vAVq7sYVcKiIR/images/usage_limit_migration2.png?fit=max&auto=format&n=693vAVq7sYVcKiIR&q=85&s=039120823c3ca8b2a5053b79f355d05f" alt="Workspace spend limit card with the Adjust limit button" style={{borderRadius: '6px'}} width="2178" height="626" data-path="images/usage_limit_migration2.png" />

    3. Set per-plan limits

    Under Spend limits per plan, set a default monthly limit for the Standard and Power user plans.

    <img src="https://mintcdn.com/odeus-34/693vAVq7sYVcKiIR/images/usage_limit_migration3.png?fit=max&auto=format&n=693vAVq7sYVcKiIR&q=85&s=036787f8228ce9fc148796a87f4ba287" alt="Spend limits per plan with monthly, weekly, and session amounts for the Standard and Power user plans" style={{borderRadius: '6px'}} width="2028" height="632" data-path="images/usage_limit_migration3.png" />

    Then set a Cost limit fallback model, and make sure to add input and output token prices for every model so usage is tracked. Without prices, usage on that model isn't counted. For these steps and for group and individual limits, see Usage and spend limits.

    Keep a per-model message limit

    Message limits you previously configured per model still apply. You can leave them unchanged, but if you want to rely primarily on cost-based limits, raise them so users don't hit a message limit before reaching their cost limit. As a baseline for spam protection, we recommend 250 messages per 3 hours per model.

    1. Open model settings

    Navigate to Models in your Workspace Settings.

    <img src="https://mintcdn.com/odeus-34/693vAVq7sYVcKiIR/images/usage_limit_migration4.png?fit=max&auto=format&n=693vAVq7sYVcKiIR&q=85&s=fe29a3d0d9a7272b89f81b06dcfb25ec" alt="Workspace settings navigation with the Models section selected" style={{borderRadius: '6px'}} width="2178" height="1172" data-path="images/usage_limit_migration4.png" />

    2. Edit each model

    Open the model's configuration and set Max messages per user to 250 for 3 hours.

    <img src="https://mintcdn.com/odeus-34/693vAVq7sYVcKiIR/images/usage_limit_migration5.png?fit=max&auto=format&n=693vAVq7sYVcKiIR&q=85&s=d93fee4fd22af2115bcba8dd9563d9b5" alt="Model configuration with the Max messages per user field and a 3-hour time window" style={{borderRadius: '6px'}} width="2608" height="1400" data-path="images/usage_limit_migration5.png" />

    Usage is now capped by monthly spend, with weekly and session pacing, and users fall back to your chosen model when they reach a limit. Counting starts when you configure limits; past usage isn't counted.


    Last updated: June 2026