Usage & billing

Before you run

The app shows the current pricing and provider options for a tool. Read the quote and any usage-based terms before submitting a request. Prices are integer micros of USD: maximumChargeMicros: 15000 is USD 0.015.

Prices, available models and provider terms can change. The website catalog helps you find a capability; the quote gives the price of the exact call.

Reserve and settle

1. A quote is free and returns the most a call can cost.
2. Submitting checks your balance and spending limits and reserves that amount.
3. When the call ends, Relvo charges its actual cost once and returns the rest. A provider failure that cost nothing is not charged.
4. A needs_review execution keeps its reservation until Relvo reviews it.

Plans and included calls

Every plan includes 20,000 tool calls per plan month, including searches, catalog pages and calls on your own provider keys. Each further 256 KiB of a response, and artifact downloads by size, also count. After that each costs 300 micros (USD 0.0003). A paid plan also includes its price as balance each month. See Pricing for the plans.

A custom API endpoint can raise its limits from 5 seconds and 1 MiB to as much as 5 minutes and 14 MiB. Each call of such a tool also costs USD 0.0003 for each started 5 seconds after the first 5 and each started 256 KiB after the first 1 MiB, from your balance and never from included calls. The quote reserves both limits and the unused part is returned. A call past a limit fails with platform_custom_endpoint_no_answer. It may still have reached the API, so check before repeating a write.

Quotes, reading your project and usage, reading a tool’s definition and your connections, and receiving trigger webhooks cost nothing.

Who pays

Each execution reports funding: relvo is paid from your Relvo balance, provider is billed by your own provider key or connected account, and mixed is some of each.

A person can add their own key for a supported provider in the app; the API and agents never accept provider keys. Your provider bills the usage on your key; Relvo charges only the per-call fee once your included calls are used. If you pin provider, the call runs only on your key. With automatic routing, if your key is refused or cannot be used, Relvo may run the same call on its own key and charge your balance. Your provider’s plan, permissions and quotas still apply.

Spending limits

Team administrators set the team’s monthly and daily limits in Billing ↗. A project’s monthly limit needs a team administrator who also administers that project. A key’s owner can set or lower its daily limit in API keys ↗; raising or removing it needs a project administrator. A reservation above a limit fails with platform_insufficient_balance_or_spending_limit_reached, and details.reason is one of:

balance
  Not enough balance.

organization_monthly_limit
  The team's monthly limit.

project_monthly_limit
  The project's monthly limit.

organization_daily_limit
  The team's daily limit (days start at 00:00 UTC).

api_key_daily_limit
  The key's daily limit.

Review recorded usage

Open Usage ↗ in the relevant project. Use the tool and execution identifiers to connect a request with its recorded activity.

Use separate keys for your integrations to make usage easier to understand.

Manage billing in the app

Open Billing ↗ for the controls available to your team and role. Review the current terms shown there before making a purchase or changing a plan.

If an amount or execution needs investigation, keep its identifier and contact support.