Billing and pricing

You pay from a prepaid dollar balance your team shares. No subscription, and the balance never expires.

How it works

1. Add funds on the Billing page, which shows the minimum.
2. You pay for each accepted request, even if it finds nothing. Rejected requests (errors) are free, and so is a request whose reply never reaches you (it timed out or your connection closed first). A one-time agent is charged even if its run fails. A creator, sound, or hashtag lookup that fails (for example, the handle doesn't exist) is refunded later, as is a post collection that finds nothing.
3. Optional: turn on auto top-up in Settings to refill from your card when you run low.

Scheduled charges

• Recurring agents: free to create, then $0.50 per run ($1.50 with Data Intelligence). The first run starts right away, so your balance must cover it.
• Tracking: $0.25 to start (covers the first check), then $0.25 per check. Asking for a creator's older posts (collection_depth) adds a one-time $0.50, $1.00, or $2.00.

Runs and later checks never show up in X-Cost. See each one on the Usage page, or check your balance for free.

If your balance runs out, these pause, and adding funds won't restart them. To resume, set active: true with Update agent, or status: active with Update tracking.

Check your balance

Returns your team's balance. Free.

curl https://api.virlo.ai/v1/account/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "balance": "$259.25",
    "credits_remaining": 25925,
    "status": "active"
  }
}

Prices

Full list below.

Data Intelligence add-ons

An AI breakdown of each video:

• Agents: data_intelligence_enabled: true adds $1.00 per run (details). On a recurring agent, turning it on or off later affects only future runs.
• Creator lookups: data_intelligence=true adds $0.25, so a lookup costs $0.75. You get each video's hook, content format, and visual style, plus a summary of what's working.

Response headers

Only successful responses carry these. Amounts have no $ sign.

• X-Cost: the exact charge in dollars (0.00 if free). X-Credits-Used gives it in credits.
• X-Balance-Remaining: your balance afterward, on endpoints that can charge, even when this call was free. Only X-Cost shows your charge. X-Credits-Remaining gives the balance in credits.

Insufficient balance

If your balance can't cover a request, you get a 402 and aren't charged. Messages vary, so read code, required_credits (price), and remaining_credits (balance), both in cents.

{
  "statusCode": 402,
  "message": "Insufficient balance. $0.25 required, $0.12 remaining. Add funds at https://dev.virlo.ai/dashboard/billing",
  "error": "Payment Required",
  "required_credits": 25,
  "remaining_credits": 12,
  "required_amount": "$0.25",
  "remaining_balance": "$0.12",
  "code": "insufficient_credits"
}

On auto top-up? The card charge may have failed, so check Billing. A 429 means too many requests, not low funds (Rate limits).