Billing and credits
How Agent API runs are paid for, free credit, top-ups and running out.
- A run did poor work. Can I get my credits back?Runs are billed for the work done. If you believe you were charged wrongly, email support with your Account ID and run ids.FAQ
- Are my credits shared between the Agent API and the Model API?Yes. There's one credit balance per Account ID, used by both the Agent API and the Model API.FAQ
- Can I set a spending limit for the Agent API?Your credit balance is a natural cap. Teams can set per-member monthly limits; you can also enforce budgets in your own code.FAQ
- Does changing or cancelling my plan affect the Agent API?No. Plans cover app usage; the Agent API is pay as you go from credits on every plan, Free included.FAQ
- How do I build my own low-balance alert for the Agent API?Poll GET /v1/account on a schedule with a read-only key and alert yourself when balance_usd drops below your threshold.How-to
- How do I get an invoice for Agent API usage?Credit purchases and billing history are in Console › Billing. For a specific invoice need, email support.FAQ
- How do I test my integration without spending much?Check keys with /agent-config, use tiny tasks on flash, keep a small top-up as a cap, and mock the API in unit tests.How-to
- How is the Agent API billed?Agent API runs are pay as you go from your credit balance: tokens at the tier each call ran on, plus computer time, actions, browser and storage.Explainer
- My paid plan doesn't seem to cover Agent API runs. Why?Plans cover app usage only. The Agent API and Model API are always paid from credits, on every plan.FAQ
- My run failed with out_of_credits halfway through. What happened?Your balance reached zero during the run, so it stopped as failed with error.code out_of_credits. Top up and start a new run.Troubleshooting
- What do metered_usd and "unlimited" mean in my account data?metered_usd is the list price of everything metered. It equals spent_usd unless the account is a Clatter Labs team account.FAQ
- Who pays when a team member starts a run?Team members use the owner's plan and credits, so the owner's balance pays, within limits the owner sets.FAQ
- Why does GET /v1/account show Line CLI usage too?The account endpoint reports 30 days of usage across Line CLI, Cosmos Agent and the Agent API, split in by_product_30d.FAQ
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.