Credits, prices and daily caps with AI apps

An app that can Make things and spend credits pays for each run from your balance, at the price the same run costs on its studio's page: see What a run costs, and where you see the price. Reading your account costs nothing, and so do importing products, bringing files in, making share links and making a board from a template.

The price comes first

Every run takes two steps:

1. The price. The app asks what the run would cost. Nothing runs and nothing is charged. It's told the price, your balance, and any notes the studio would show you for the same settings. If the run would take the app past its daily cap, it's told that too.
2. The go-ahead. The app is asked to show you that price and wait for your yes. Then it confirms the price it was given, and only then does the run start, charged that price.

The price is checked again at the go-ahead. If it has gone up in between, nothing runs: the app is given the new price to show you. If it has come down, the run goes ahead at the lower price, as it would on the page. A figure the app was never quoted doesn't count as a yes, so nothing runs on one.

An app left to work on its own, such as a coding agent running without you, can give the go-ahead without asking. A daily cap is how you limit what any app can spend.

If your balance is too low, the app is told how many more credits the run needs and where to add them. An app can't buy credits for you. See Buy credits without a plan.

The same request twice

Each request an app makes carries an id of its own. If the app sends the same request again within 10 minutes, for instance because it never heard back, it gets the first answer, and nothing runs or is charged a second time. A new request is a new run, priced and charged on its own.

Daily caps

A daily cap is the most one app or key may spend in a day. It's optional: a connection has no limit unless you give it one.

• When you connect: on the page where you press Allow, or when you make a key, under Daily credit cap.
• Any time after: in Connected apps, press the app or key, type a number under Daily cap and press Save. Empty it and save for no limit.

A day runs from midnight to midnight UTC. A run that would take the app past its cap doesn't start, and the app is told how many credits it has left today. It can carry on the next day, or as soon as you raise or remove the cap. An app or key that can only see your account spends nothing, so it has no cap.

The cap counts what each run was charged when it started. If a run fails later, its credits come back to your balance as usual, but they still count toward that day.

When a run fails

A run an app started is refunded like any other: every credit it was charged comes back automatically. The app is told that it failed, why, and whether it was charged, and is asked to check with you before trying again. Trying again is a new run, at the price it's shown. See My video failed. Did I lose my credits?

On a team's board

A card an app runs on a team workspace's board is paid the way the card's Run button pays: from the workspace's credits when you're a member. See Business: teams, seats and invoices.

What each app spent

Connected apps shows:

• above the list, what all your apps and keys spent this week;
• on each row, its Daily cap and its Credits this week, with a bar for each day;
• in each one's panel, under This week, the week's total, today's, its cap and the last seven days.

A week here is today and the six days before it, by UTC. Each charge is also on your statement in Usage, listed like a run you started yourself. The statement doesn't say which app it came from.