> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreamlayer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing

> What a DreamLayer Agent API credit costs and when it is charged.

# Pricing

DreamLayer bills one credit per successful ordinary image. Sprite sheets use frame-count pricing, and Video uses an approved quote. There is no subscription and no per-seat charge.

## Credits

* One public API credit costs \$0.15 for new purchases. Existing balances are unchanged. New sprite estimates and video quotes use the usage prices below; previously accepted jobs and valid stored quotes retain their original charge.
* Every finished image costs one credit, whichever operation produced it: text-to-image,
  image-to-image, background removal, or upscale.
* A run that fails costs nothing. The credit is reserved when the job starts and released
  if it never produces an image.
* The minimum public purchase is 59 credits, or \$8.85. A single purchase can contain up to 4,000 credits (\$600).
* Credits do not expire.
* Auto-reload is not currently available.

A new account starts at zero credits. Buy a pack before your first call.

## What counts as a successful ordinary image

A live job reserves one credit and settles it only after the image is delivered. A failed or cancelled job that does not deliver the contracted result restores the reserved credit automatically, so a provider outage does not cost you anything.

Purchased API credits are non-refundable.

## Video

Video uses API credits from the same balance, but is not a one-credit image operation. Request `POST /v1/video/quotes`, review `customer_price.amount`, then accept it with a sufficient `max_credits` ceiling of at most 100. Quoting does not start generation or reserve generation credits.

Video costs **3.3 API credits per requested second**. Sound is on by default and costs the same as sound off. The default is 10 seconds at 720p. The returned quote confirms the available settings and charge before you accept it.

| Duration | API credits | Public equivalent at \$0.15 per credit |
| - | - | - |
| 5 seconds | 16.5 | \$2.48 |
| 10 seconds | 33 | \$4.95 |
| 15 seconds | 49.5 | \$7.43 |
| 20 seconds | 66 | \$9.90 |
| 30 seconds | 99 | \$14.85 |

USD equivalents are rounded for display, not charged separately. Supported duration depends on the requested video. Video always uses the API wallet, including on the browser video page.

Acceptance reserves the quote; owned MP4 delivery settles it once. Failed or eligible cancelled jobs restore the hold. Long-unresolved jobs can be refunded before their final state is known; later delivery after restoration is not charged again. Check the execution's billing fields. See [Video settings and pricing](/agent-api/video-settings) and [recovery](/agent-api/video-jobs).

## The CLI and MCP server cost nothing extra

Both are free to install and both spend from the same balance as a direct API call. One image is one credit regardless of which of the three you used to ask for it.

## Check your balance

Open `platform.dreamlayer.io/console/billing` to see purchased credits, and the usage page to see reservation, settlement, and restoration state. Neither page shows prompts, images, or routing details.

## Next steps

* [Create an API key](/agent-api/api-keys)
* [Send your first request](/quickstart)
* [Install the CLI](/cli)

## Sprite-sheet beta

The sprite beta is available to authenticated accounts under normal credit and
quota checks. API, CLI, and MCP requests share the API balance. The App Sprite
Sheets page uses the separate App balance.

Request 7–100 frames, with 12 as the default. Transparent sprite sheets cost
**4.2 API credits plus 0.2 per frame**, including exports. Export size does not
change the price. Keeping the background costs **\$0.32 plus \$0.01 per frame**,
converted to credits at your account's undiscounted purchase rate and rounded
upward to four decimal places.

| Frames | Transparent API credits | Public equivalent at \$0.15 per credit |
| - | - | - |
| 7 | 5.6 | \$0.84 |
| 12 | 6.6 | \$0.99 |
| 24 | 9.0 | \$1.35 |
| 100 | 24.2 | \$3.63 |

Use authenticated `GET /v1/sprite-pricing?frame_count=12&background=remove` for
your account's current estimate. It returns decimal-string `credits`,
`reference_usd`, `reference_credit_cents`, `price_version`, and `binding: false`.
This is an estimate, not a reservation: submission checks the current price again.
Use `GET /v1/capabilities?pricing=current` for the current formula. The default
capabilities pricing fields are deprecated historical estimates retained for old
clients; they must not be used to calculate today's charge. Set `max_credits` to
the amount you approve. A ceiling below the actual price refuses without a debit.
The total is held when the job starts and settled only on complete delivery.
Failure or timeout restores the hold. Sprite requests have no customer
cancellation. Image operations keep their one-credit price.

See [sprite sheets](/agent-api/sprite-sheet) for exact rounding examples and
animation options. Broad animation requests do not guarantee successful results.

## App sprite prices and discounts

App sprites target the same public dollar prices using the standard \$0.35 App
credit denomination, rounded upward to four decimal credits. Monthly credits
and discounted credit purchases still buy the same amount of usage, so those
discounts remain savings. App and API credits are not interchangeable.

Enter an eligible discount code in the App's one-off top-up dialog or in the
API console's top-up dialog. Codes have an expiry and redemption limit. One code
can apply to a purchase; codes do not apply to subscriptions or stack with
private agency pricing. A discount reduces the payment, not the credited quantity.
Review the final total in Stripe before paying. Referral rewards and automatic
agency payouts are not available in this release.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.