> For the complete documentation index, see [llms.txt](https://docs.avastudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avastudio.com/api-and-mcp/credits-and-pricing.md).

# Credits and pricing

The API uses the same credits as Ava Studio, from your account's balance, on every plan. Reading things is free; tools that research, draft, plan or make media cost credits.

#### Free accounts and starter credits

**Creating an API key and connecting through MCP are free.** No paid Ava plan is required to use REST, MCP, the SDK or the CLI. Keys and connected apps still need the permissions for the tools they call.

Eligible free accounts receive **one 500-credit starter grant after their first brand is ready**, not at sign-up. It is added to the account's normal balance and can pay for research, briefs, planning and media across **Studio, MCP, REST, SDK and CLI**, on any of your campaigns or projects. It is not a monthly allowance, and unspent starter credits expire **14 days after the grant**.

Set up your brand in Studio or give your connected agent its website. An eligible new free account's first website-based brand setup is free, including through `brand_create`, so setup can finish before the grant is awarded.

Eligibility requires a verified, non-disposable email, a qualifying finished brand and a successful bot check. Accounts that have already paid, received a starter grant or used the old campaign trial do not receive another grant. Brand-identity checks and daily abuse limits can also prevent a grant. An account can still create keys and connect if it does not qualify for credits.

Check `whoami` for your current `credits_balance`. If a starter grant exists, `starter_credits` reports its status and expiry; `granted_credits` is the original grant amount, not a separate remaining balance. The old first-campaign trial is a separate allowance and cannot fund general API charges.

Paid operations require enough available credits and monthly key or connection budget for their upfront holds. A Free plan does not make these operations free. If the balance cannot cover the work, the call returns `insufficient_credits`; free reads and account access remain available. A monthly budget does not add credits to your account.

#### Free-plan limits

Free accounts can generate video at **720p or below** with models costing **at most 20 credits per second**. These limits apply to the account's plan, including when it has starter credits. Use the free `models_list` and `generation_estimate` tools to choose supported settings and check the price before generation.

Free accounts also have lower research and drafting limits; see [Rate limits](https://docs.avastudio.com/api-and-mcp/jobs-retries-and-errors.md#limits). Exports follow the owner's entitlement: Free owners can use a watermarked export; removing the watermark requires a paid owner. See [Project exports](https://docs.avastudio.com/api-and-mcp/project-agent.md#conversation-history-and-turn-outcomes).

#### How tools are priced

| Price            | What it means                                                                                                            | Examples                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| **Free**         | No credits.                                                                                                              | `brand_list`, `draft_get`, `campaign_create`, `timeline_add`                        |
| **Flat**         | A fixed price per call or per item.                                                                                      | `research_trends` 1 credit, website research with `brand_create` 40, `plan_run` 200 |
| **+ tokens**     | A base price plus the AI usage of the call, which varies with the work. Each tool's description gives the typical total. | `draft_briefs` 10 credits per brief plus tokens, typically about 25 per brief       |
| **+ media**      | A fee plus the images and videos it makes, at Ava Studio's prices.                                                       | `creative_produce` 50 credits plus media                                            |
| **Studio price** | Exactly what the model and settings you pick cost in Ava Studio.                                                         | `image_generate`, `video_generate`, `scene_generate`                                |

The [tool reference](https://docs.avastudio.com/api-and-mcp/tools.md) lists the price of every tool. `brand_create` with a supplied `profile` is free and runs no research or media analysis; only name is required, and a website is optional. URL-based brand research costs 40 credits, with the existing eligible first-brand allowance.

#### Studio generation: the same price as in Ava Studio

The Studio tools (images, video, audio, upscaling, templates, scenes, captions and B-roll) cost exactly what the same generation costs in Ava Studio. There is no API fee: a generation that costs 40 credits in the app costs 40 through the API.

Know the price before you run anything:

* `models_list` shows every model with its options and Studio prices.
* `generation_estimate` quotes up to 20 generations at once, with the credits for each and the total.

Both are free.

#### When credits are taken

1. **When a paid call starts, Ava checks your balance and the key's monthly budget.** It holds credits for the API call; media jobs also count their estimated media cost toward the budget. If the upfront amount can't be covered, the call is refused with `insufficient_credits` or `budget_exceeded` before it runs.
2. **When it finishes, unused API holds are released.** Media generation is charged separately at Studio's prices. The final media cost can exceed the initial estimate when production needs additional work or repairs.
3. **If a job fails, unused holds are released.** Media already produced can still be charged, even if the overall job fails. An API timeout or interruption can leave production running; check the project in Studio before starting new work with a different idempotency key.

Every result says what it cost: `credits_charged` for the API's own price, and `media_credits_charged` for the media it made. While a job runs, `jobs_get` shows `credits_held` and, for media, `media_credits_estimate`.

For media, a monthly budget limits the estimated cost admitted at the start. See [Monthly budgets](https://docs.avastudio.com/api-and-mcp/api-keys.md#monthly-budgets) for how estimates and final media charges affect budget usage.

Retrying with the same `idempotency_key` never charges twice. See [Jobs, retries and errors](https://docs.avastudio.com/api-and-mcp/jobs-retries-and-errors.md#retries).

#### Ask Ava

`ava_ask` costs 40 credits per message plus tokens. Through the API, Ava reads your campaigns, answers and suggests, and with the Manage campaigns permission can approve concepts and edit drafts. She starts nothing else that spends credits: planning, drafting, research and production are for your agent to run with their own tools.

#### Keep spending in check

* Give each app or script its own key, with a **monthly budget** ([API keys](https://docs.avastudio.com/api-and-mcp/api-keys.md#monthly-budgets)).
* Connected apps get a budget too, 1,000 credits by default ([Sign in with Ava](https://docs.avastudio.com/api-and-mcp/sign-in-with-ava.md)).
* Use a **Read only** key or connection for agents that only need to look.
* The Developers page shows what each key and app spent this month.
