Virlo

Billing & Pricing

The Virlo API bills from a prepaid dollar balance. Add funds to your account, and each successful API call deducts cost based on the endpoint. Auto top-up can keep your balance funded automatically—no subscriptions required.

How It Works

  1. Create an account and add a payment method — Secure your billing profile before you deposit or use paid endpoints.
  2. Deposit funds (minimum $10) — Choose a preset amount or a custom deposit; your balance is credited in credits where 1 credit = $0.01.
  3. Use the API — Each call costs credits according to the endpoint; only 2xx responses are charged.
  4. Auto top-up (optional) — When enabled, we can add funds automatically when your balance drops below your threshold so usage stays uninterrupted.

Key Benefits

  • ✅ No subscriptions — Pay-as-you-go from your balance only.
  • ✅ Balance never expires — Funds remain available until you use them.
  • ✅ Auto top-up enabled by default — After your first deposit, you can keep it on or adjust it in Settings.
  • ✅ Pay only for what you use — Charges apply per successful request, by endpoint pricing.

Pricing Per Endpoint

Endpoint costs are expressed in credits (1 credit = $0.01). The table below reflects current pricing:

Unable to load pricing information at this time.

Costs may change over time. Visit Dashboard Pricing for the latest per-endpoint rates.

Data Intelligence Add-on

When you enable data_intelligence_enabled: true on an Orbit or Comet request, an additional $1.00 is charged per run on top of the base $0.50 cost ($1.50 total per run).

ScenarioBaseIntelligenceTotal
Orbit without intelligence$0.50—$0.50
Orbit with intelligence$0.50+$1.00$1.50
Comet without intelligence$0.50/run—$0.50/run
Comet with intelligence$0.50/run+$1.00/run$1.50/run

Intelligence provides 40+ structured AI fields per video — topics, hooks, tone, brand safety, visual format, CTAs, and more. See the Data Intelligence reference for the full field list.

When an intent is provided along with Data Intelligence, intent-based filtering using the 40+ intelligence fields is included at no additional cost. The system evaluates each video against your intent and provides intent_match results and an intent_summary on the run response — all covered by the existing Data Intelligence fee.

Adding Funds

You can add money from the Billing dashboard:

  • Preset amounts: $10, $25, $50, or $100
  • Custom amount: any value ≥ $10.00

Billing uses a flat rate: 1 credit = $0.01 (e.g. $10.00 adds 1,000 credits to your usable balance). Manage cards and deposits on your billing page.

Auto Top-Up

Auto top-up is enabled by default after your first deposit. You can tune when and how much we add:

  • Threshold: balance level that triggers a top-up ($5–$100)
  • Top-up amount: how much we charge and credit each time ($10–$100)

How it works:

  1. After requests, we monitor your remaining balance against your threshold.
  2. When balance falls below the threshold, we charge your saved payment method for the configured top-up amount.
  3. Credits are applied immediately so the API can keep serving successful calls.

Manage auto top-up, thresholds, and amounts in Dashboard Settings.

Checking Your Balance

  • Dashboard: Open Billing to see balance, history, and billing controls.
  • Response headers on API responses include:
    • X-Credits-Remaining — credits left after the request (1 credit = $0.01)
    • X-Balance-Remaining — dollar balance remaining (e.g. "111.01")
    • X-Cost — dollar cost charged for the request (e.g. "0.25" means $0.25 = 25 credits)
    • X-Credits-Used — credits consumed for that request (e.g. 25)

What Happens When Balance Runs Out?

When your prepaid balance is insufficient for a call:

  1. The API returns 402 Payment Required (not 429).
  2. If auto top-up is enabled and the charge succeeds, balance is replenished and you can retry.
  3. If payment fails, update your payment method in Billing and re-enable auto top-up if it was turned off after a failure.

FAQ

Does my balance expire?

No. Your prepaid balance does not expire.

Do failed requests cost anything?

No. Only successful responses (2xx status codes) consume credits.

What's the minimum deposit?

$10.00 minimum for deposits and custom amounts.

How does auto top-up work?

When your balance drops below your configured threshold, we charge your saved payment method for your configured top-up amount and credit your account immediately.

Can I disable auto top-up?

Yes. Turn it off (or back on) from Dashboard Settings.

What if my payment method expires?

Auto top-up fails and is disabled. Add or update your payment method in Billing, then re-enable auto top-up if you want it.

Do I need a subscription?

No. Virlo API billing is pay-as-you-go from your prepaid balance—no subscription required.

Need Help?

Was this page helpful?