Credits
What consumes credits, when the charge happens, how to know the price upfront and how to check the statement.
Credits are the workspace balance. Every route that charges tells you the price before charging, and every debit shows up in the statement with the id of what caused it.
What is charged
| Action | When it is charged | How to know the price upfront |
|---|---|---|
Clipping (POST /clips) | when the submission is created | credits_cost in POST /clips/info |
Caption translation (translate_to) | together with the clipping | credits_charged in the POST /clips response |
Transcription (POST /transcriptions) | on creation, per minute of audio, plus an extra with speaker_labels | credits_charged in the response |
| Live monitoring | for each 10-minute block that generated clips, only while the monitor is on | |
| Image, video, voice, music, sound, avatar, 3D and tool generation | on creation, at the price you sent | GET /models and POST /generations/quote |
| Chat and embeddings | by the token, in fractions of a credit that leave the balance one whole credit at a time | GET /models |
| Persona: photo and video | on creation | GET /personas/catalog and GET /personas/swap/quote |
Reading, listing, analyzing, rendering and publishing do not charge.
Check the price upfront
POST /clips/info charges nothing and returns the exact clipping cost:
{
"id": "7412908365112823",
"duration": 213,
"credits_cost": 4,
"credits_original": 5,
"discount_percent": 20,
"current_balance": 120,
"credits_unlimited": false
}credits_original and discount_percent show the discount applied, when there is one.
Balance
curl https://api.cut.pro/api/v1/balance \
-H "X-Api-Key: $CUTPRO_API_KEY"{ "balance": 120, "unlimited": false, "unlimited_until": null }Insufficient balance
The route returns 402 before creating the job, and nothing is charged:
{
"code": "INSUFFICIENT_CREDITS",
"extra": { "credits_needed": 121, "current_balance": 40, "is_owner": true }
}credits_neededandcurrent_balancetell you how much is missing.is_ownertells you whether the key's owner can buy credits for this workspace.- In generation, persona and chat,
extra.top_up_urlis the cut.pro page where the person gets more credits, already in this workspace. To show prices and a link that goes straight to payment, useGET /balance/offers.
Buy credits or a plan
GET /balance/offers is free and lists what this workspace can buy, at the price cut.pro charges this user, in their currency:
curl "https://api.cut.pro/api/v1/balance/offers?language=en" \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"can_buy": true,
"current_plan": { "id": "1410063392449888256", "name": "Gratuito", "is_free": true },
"plans": [
{
"id": "1410063392600883200",
"name": "Plus",
"currency": "BRL",
"credits_per_month": 1000,
"monthly_price_cents": 6990,
"annual_price_cents": 69900,
"highlights": ["Clipes sem marca d'água, prontos pra postar", "Processamento prioritário dos seus clipes"],
"current": false,
"monthly_checkout_url": "https://cut.pro/checkout?planId=1410063392600883200&billingCycle=monthly&workspace_id=...",
"annual_checkout_url": "https://cut.pro/checkout?planId=1410063392600883200&billingCycle=annually&workspace_id=..."
}
],
"packs": [
{ "id": "bundle_200_brl", "credits": 200, "currency": "BRL", "price_cents": 1590, "checkout_url": "https://cut.pro/checkout?mode=credits&bundleId=bundle_200_brl&workspace_id=..." }
]
}packsare one-time credits, smallest first;plansrenewcredits_per_monthevery month. Prices are in cents ofcurrency.- Each link opens the cut.pro checkout with that pack or plan already chosen, in this workspace. The person pays there; the call itself never charges.
can_buy: falsemeans only the workspace owner can pay.- Keys connected to apps that do not allow purchases inside them get
403 SOLD_ON_SITE, and theirtop_up_urlleads to the plan page on cut.pro.
Statement
GET /balance/history lists every movement, from newest to oldest:
curl "https://api.cut.pro/api/v1/balance/history?type=debit&limit=20" \
-H "X-Api-Key: $CUTPRO_API_KEY"{
"transactions": [
{
"id": "7412908372201188",
"type": "debit",
"amount": -4,
"balance_after": 116,
"reference_type": "usage",
"reference_id": "7412908371004912",
"description": null,
"waived": false,
"expires_at": null,
"created_at": "2026-10-29T18:01:12.000Z"
}
],
"pagination": { "current_page": 1, "total_pages": 1, "total_count": 1, "has_next_page": false, "has_previous_page": false, "limit": 20 }
}amount is negative on a debit and positive on a credit. reference_id points to what caused the movement (the submission, the subscription, the refund). expires_at is only filled in for credits that expire. Filter by type and reference_type.
Refunds
- Canceled clipping:
DELETEon a submission still processing cancels it and returns the credits. - Failed generation: comes back on its own. A finished generation that came out wrong can have a refund requested at
POST /generations/{id}/refund, before downloading or posting, and the team decides. - Repeated or speechless transcription: audio already transcribed comes back from the cache with
credits_charged: 0, and audio with no speech ends asno_speechwith no charge. - Unnecessary translation: if the video is already in the
translate_tolanguage, the translation extra is returned.
Free usage
A workspace can be on free usage. While it lasts, jobs run without consuming credits and are never refused for balance.
GET /balanceshowsunlimited: trueandunlimited_until(nullmeans no end date).GET /workspacereturns the same incredits_unlimitedandcredits_unlimited_until.POST /clips/inforeturnscredits_unlimitedalongsidecredits_cost.
The statement keeps recording everything: each job appears with the amount it would have cost and waived: true, and balance_after does not change. Real charge fields, like credits_charged, come as 0.
AI generation and personas always consume credits, even on free usage.