Credits

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 chargedCopy Anchor Link

Reading, listing, analyzing, rendering and publishing do not charge.

Check the price upfrontCopy Anchor Link

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.

BalanceCopy Anchor Link

curl https://api.cut.pro/api/v1/balance \
  -H "X-Api-Key: $CUTPRO_API_KEY"

{ "balance": 120, "unlimited": false, "unlimited_until": null }

Insufficient balanceCopy Anchor Link

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_needed and current_balance tell you how much is missing.
• is_owner tells you whether the key's owner can buy credits for this workspace.
• In generation and persona, extra.top_up_url is the page where credits are bought. Show it to the person.

StatementCopy Anchor Link

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.

RefundsCopy Anchor Link

• Canceled clipping: DELETE on 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 as no_speech with no charge.
• Unnecessary translation: if the video is already in the translate_to language, the translation extra is returned.

Free usageCopy Anchor Link

A workspace can be on free usage. While it lasts, jobs run without consuming credits and are never refused for balance.

• GET /balance shows unlimited: true and unlimited_until (null means no end date).
• GET /workspace returns the same in credits_unlimited and credits_unlimited_until.
• POST /clips/info returns credits_unlimited alongside credits_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.