Skip to content
Docs

Documentation

Quotes and credits

Understand Raywake credit quotes, generation holds, usage-based settlement, failed-job releases and the balance shared by studio and API.

You always see the price before anything runs. A quote prices one exact input; a generation must present a valid quote for that same input.

The lifecycle of a charge

  1. Quote. POST /v1/quotes returns the credits for the input and an expires_at (at most 10 minutes).
  2. Hold. Starting the generation reserves the quoted credits. They leave your available balance but are not spent yet.
  3. Settle. On success the credits are captured. On failure they are released back to your balance.

Models billed by usage

Some models are billed by what they actually produce, such as seconds of video or characters of speech. For these the quote is an upper bound: the hold covers the largest charge your options allow, and after the run you are charged the measured amount and the rest is released.

Changing any input after quoting invalidates the quote. Request a new quote with the final input, then generate.

Balance

GET /v1/wallet returns available, reserved and owed credits. Owed credits appear only after a payment reversal; new top-ups clear them first.

Next: Generations →