Skip to main content

​
How credits work

Every API operation costs a fixed number of credits. Credits are deducted immediately when a request is accepted. Each credit costs $0.10 USD. Buy as many as you need — there’s no minimum or subscription.

​
Credit costs

OperationEndpointCreditsCost
Video generationPOST /v1/videos/generate6$0.60
Image generationPOST /v1/images/generate4$0.40
Music generationPOST /v1/music/generate3$0.30
Account creationPOST /v1/accounts10$1.00
Post schedulingPOST /v1/posts3$0.30
Media analysisPOST /v1/analyze1$0.10
ScrapingPOST /v1/scrape1$0.10
Text overlayPOST /v1/overlay1$0.10
Free operations (0 credits): All list/read endpoints, pricing, balance checks.

​
Checking your balance

curl https://api.vidjutsu.ai/v1/balance \
  -H "X-Api-Key: vj_live_abc123..."

{
  "credits": 84,
  "clientId": "cl_xyz789"
}
Or with the CLI: 
vidjutsu balance

​
Topping up

​
Via the API

curl -X POST https://api.vidjutsu.ai/v1/auth/setup \
  -H "Content-Type: application/json" \
  -d '{ "credits": 500, "email": "you@example.com" }'

​
Via the CLI

vidjutsu topup 500
Pay with any card via Stripe. Credits are added to your existing balance immediately after payment.

​
Insufficient credits

If you don’t have enough credits for an operation, the API returns a 402 error: 
{
  "error": "insufficient_credits",
  "message": "This operation requires 6 credits but you have 2",
  "setup": "/v1/auth/setup"
}

​
Getting pricing programmatically

curl https://api.vidjutsu.ai/v1/pricing

{
  "pricePerCredit": "$0.10",
  "costs": {
    "video": 6,
    "image": 4,
    "music": 3,
    "account": 10,
    "post": 3,
    "analyze": 1,
    "overlay": 1
  }
}