Skip to content

Billing, Credits & API Keys

Usage is metered in credits on AI-voice time — the seconds a voice model is actually connected to your call, prorated without rounding up minutes. Check Billing for the current platform and AI rates, and Account for credit purchase prices. Rates and offers may change.

A call on Parrot's shared AI key has a separate AI fee: connection minutes × that key's configured credits-per-minute price. The key's current customer rate appears on its AI provider page. A call on your own provider key is billed for AI usage by your provider directly; check Billing for the applicable Parrot charges. Billing and provider pages show the same current prices. If prices cannot be loaded, the console shows an unknown price.

Each connection keeps its price. Switching keys during a call prices each key's connected time separately; reconnecting the same key retains its current price. This page covers the Billing page (balance, ledger, usage), the Account page (your limits), and API keys.

The Billing page

Open Billing in the console. The credits pill in the top bar opens Account, where you can review invitation rewards or top up.

The Usage rates table is at the bottom of Billing. Switch between Per minute and Per hour to compare prices; charges are still prorated by the second. Provider details show Pricing directly below Usage. The Calls by assistant chart shows each assistant's call count and total call duration, not its charges.

Billing: balance, ledger, usage breakdowns

The screenshot shows example balances and charges. Check Usage rates in your console for current prices.

Up top, four numbers:

  • Credits remaining — your credit balance. Turns red at zero.
  • AI-voice minutes (30d) — how much model-connected time you've used.
  • Credits used (30d) — what that time cost.
  • Calls (30d) — how many, their average length, and how many were answered.

The top-up on Account shows the available credit package and its current purchase price. Review that offer before continuing to the one-time payment through Stripe Checkout. Credits arrive only after payment is confirmed. Cancelling adds no credits. If confirmation is delayed, use Check payment status on your return page; checking again cannot credit the same purchase twice.

If payments have not been enabled, the page says so. Invitations remain available. When a payment is refunded, the corresponding credits are deducted and shown as a separate Payment refund movement.

The ledger

Every movement is its own row. Platform fee and AI fee are shown as separate entries linked to the same call, where applicable. Each entry shows the amount recorded for that usage. Long calls can have several entries as usage is recorded during the call. Purchases, grants and refunds each have their own entries too.

The Balance column is the actual stored balance after that movement. The page shows the 200 most recent movements, with ten rows per page.

Usage breakdowns

Below the ledger, your last 30 days sliced up: calls per day, calls by protocol (the AI vendor), by client (API key) — calls and minutes per key, listed by the start of its key ID as shown on the API keys page (calls placed by hand in the console show as "Manual / dashboard") — calls by assistant, and an outcomes row (how many calls ended in each outcome).

Limits that protect you

The guardrails all refuse a call before dialing rather than surprising you afterward:

  • Balance required — current pricing determines whether a new AI session requires a positive balance. Check the applicable rates in Billing. A call already in progress is not cut off when the balance reaches zero; its remaining usage is still charged.
  • Per-call duration cap — every call carries a maximum duration; ask for more than your account's ceiling and it's quietly lowered, never errored. When time runs out, the call is ended cleanly. Your ceiling is shown on the Account page; console-placed calls use a 5-minute cap on top of it.
  • Daily calls — there is currently no daily call-count cap. Balance and duration requirements still apply.

An agent connected over MCP hits exactly the same guardrails — a key can never spend past the account's limits.

The Account page

Account (separate from Billing in the sidebar) is your profile plus the account's standing limits: how many devices you can register, and the maximum call duration that clamps every dial — the number to check if calls seem to end early. Sign-out lives here too.

Invite friends

The invite section on Account ("Thank you for helping us grow.") shows your personal invite link, referral progress and current reward amounts. Check the offer there before sharing your link (https://parrotvoice.app/r/…). When a friend joins through it and completes their first successful call, both accounts receive the invitation rewards shown in Account. The connection time those credits cover depends on the applicable usage rates in Billing.

  • Join, complete a first successful call, then both receive rewards. Your friend can check their starting credit balance in Account. Rewards are processed automatically, normally within 30 seconds of the completed call being recorded, with nothing to claim. Each friend qualifies once; failed, unanswered and repeated calls do not earn another reward. The ledger shows the bonus and running balance. Already-issued signup rewards are retained and are not issued again.
  • Track your invitations in Account. The page keeps two numbers — how many friends joined (including friends who have not called yet), and credits actually earned.
  • One friend who starts calling = one contribution. Badges and the progress bar on Account use this count, updated daily. Your own call time and repeat calls do not add contributions. New accounts start with a welcome egg badge. The sidebar shows your badge's name under your username, and the badge itself beside it once you earn one beyond the egg; progress stays on Account.
  • Public recognition uses a masked name by default, for example Y*** L***. OAuth handles use the same masking rule; names that look like contact details and missing names become Parrot member. You can turn public participation off in Account and keep your private badge. Visibility updates with the daily list.
  • Only the person you invite counts. If they go on to invite someone else, that reward is theirs; invitations don't pay upward through a chain.
  • We never show you who joined. Parrot tells you the count, not the people. The other direction is not private, though: whoever opens your link sees your username on the sign-in page ("Referred by you@example.com"), so they know who vouched for it — worth remembering before posting the link somewhere public.

Sending your own link back to yourself doesn't pay — an invite has to bring somebody new.

API keys

Open API keys in the console to connect an MCP agent to your account. Each key controls one device (one phone line) and can read call history, transcripts and recordings across your account.

Apps you connect by signing in instead of pasting a key (for example a Claude connector, see Connect your AI agent) are listed here too, and the page is then titled API keys & connected apps. Each row's Scope shows what you approved: calls on one device and call history across your account, or Account · assistants for an app that only manages assistants.

API keys: one key per agent, each bound to a line

  • Create — name the key and pick which device it's for. The secret is shown once, at creation — copy it then; it can't be redisplayed.
  • Revoke — delete a key (or disconnect an app) and whatever held it loses access immediately. (The wider trust model — board identity, ownership, what a key can't do — is on Security & trust.) Rotating = create a new key, update your agent's config, delete the old.
  • The list shows each key's name, key ID, scope (its device), creation date, and when it was last used — a key that's never used is a key you can safely revoke.
  • The fastest path for agent setup isn't even this page — each device's MCP page mints a key and drops it straight into a ready-to-paste client config (Connect your AI agent).

Since the billing page breaks calls and minutes down by key, giving each agent its own key (rather than sharing one) shows which agent is using your line.

Where this fits

Credits meter the calls; everything that makes the calls worth paying for is in the rest of the docs — start at Making & receiving calls if you're new, or its troubleshooting if a dial got refused and you're here to find out why.