Guide

Credits

Work is metered. The studio bills what a project actually costs to make, a fraction of a credit at a time.

#What things cost

One credit is $0.0025 of measured cost: the agent's model usage plus the machine time spent recording and rendering. Nothing is charged when a project is created — the meter runs as the work happens. These are typical totals, not fixed prices.

Outcome	What it makes	Billing
`demo-video`	Narrated demo of your live product	Metered
`launch-video`	Cinematic launch film	Metered
`deck`	Slide deck from a topic	Metered
`deck` with an upload and `options.mode`	Redesign of a PDF or PPTX	Metered
`recording-edit`	Cut of a screen recording	Metered
`GET /v1/` / `get_`, `list_*`	Any read	free

#Launch video exports

Launch exports are usage-metered. Higher resolutions usually consume more host compute. A turn that loads one of Pitch’s provided skills applies a 2.5x multiplier to that turn’s model usage only.

If you send no options.resolution, the default is 1080p. The meter charges the model and render time actually used.

bash

curl -X POST https://api.trypitch.co/v1/projects \
  -H "Authorization: Bearer pk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "https://acme.com — 60 second launch film for an AI notetaker. Confident, fast.",
    "options": { "resolution": "720p" }
  }'

#Reading the balance

bash

curl https://api.trypitch.co/v1/credits -H "Authorization: Bearer pk_your_key"

json

{
  "balance": 1840,
  "plan": "pro",
  "transactions": [
    { "amount": -120, "reason": "Usage: Demo video (trypitch.co)", "projectId": "cm4x...", "createdAt": "..." },
    { "amount": 10000, "reason": "Subscription renewal", "createdAt": "..." }
  ]
}

The balance is the sum of the ledger, not a stored counter. transactions returns the 20 most recent entries, newest first. Negative amounts are spend, positive are top-ups and refunds.

#Checking a price first

If you want to budget without hardcoding numbers, ask.

bash

curl https://api.trypitch.co/v1/pricing

json

{
  "model": "usage",
  "creditUsd": 0.0025,
  "computeUsdPerSecond": 0.002,
  "providedSkillModelMultiplier": 2.5,
  "explanation": "Projects are not priced up front..."
}

This endpoint needs no key. Over MCP the same payload comes back from get_pricing.

#When you run out

We check the balance before creating anything. If it is short, the request fails with 402, no project is made, and nothing is charged.

json

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits. Balance is 35. Buy more at https://trypitch.co/pricing.",
    "balance": 35
  }
}

Over MCP the same case comes back as a tool error whose text carries the balance, so the agent can tell the user how short they are. Want a video without buying credits? Ask in our Discord.

Credits remain on your balance until you use them, including credits granted by a plan that later ends. Cancelling stops future renewals; plan-specific features remain available through the paid billing period.