Windpaint
Get started

Pricing, Credits and Billing

How Windpaint bills: prepaid credits, a fixed price per output, holds that are released on failure, storage, estimates, top-ups, and a worked example.

Windpaint bills in prepaid credits. Every output has a fixed price in credits that depends on the model and the tier you ask for (resolution, and duration for video). You see the price before you submit, it’s held while the job runs, and you’re charged only if the job completes.

Credits

One credit costs $0.05 when you buy it. Credits belong to the organization, and every project and member spends from the same balance. The pricing page on windpaint.ai has the same prices at a glance.

Current prices

These are the prices at the time of writing. Prices can change, so read them from the API rather than hard-coding them (see below).

CapabilityModelTierCreditsUSD
image.generatez-image-turbo1k (1024 px long edge)0.08 per image$0.004
image.generateflux-2-klein-4b1k (1024 px long edge)0.10 per image$0.005
video.generate (coming soon)wan-2.2-i2v480p, 5 s4 per clip$0.20

Video generation is coming soon: wan-2.2-i2v’s price is listed so you can plan, but it can’t be submitted yet.

Prices are per output. An image request can ask for up to 4 images with num_outputs (see Multiple outputs) and costs the per-image price times that number; a video request makes one clip. Aspect ratio and output_format don’t change the price. Uploads, downloads, API calls that only read data, and the first 7 days of storage for each asset are free. Storage beyond that is billed (see Storage).

GET /v1/generation/capabilities is the authoritative price list. Each model under each capability carries a prices array with one row per tier:

curl
curl https://api.windpaint.ai/v1/generation/capabilities \
  -H "Authorization: Bearer $WINDPAINT_API_KEY" \
  | jq '.data[] | {capability: .id, models: [.models[] | {model, prices}]}'
{
  "capability": "image.generate",
  "models": [
    {
      "model": "z-image-turbo",
      "prices": [
        { "resolution": "1k", "duration_s": null, "credits": "0.08" }
      ]
    },
    {
      "model": "flux-2-klein-4b",
      "prices": [
        { "resolution": "1k", "duration_s": null, "credits": "0.10" }
      ]
    }
  ]
}

Credit amounts are always strings in the API, to keep them exact.

Holds: you pay only for completed jobs

  1. Submit. The job’s price is fixed and returned as credits_estimate. That amount is held from your available balance. If the organization doesn’t have enough available credit, the submit fails with 402 billing.insufficient_credits, and details tells you required and available.
  2. Complete. The hold is captured and becomes a charge. credits.actual on the job equals the estimate. If you asked for several images and the model delivered fewer, you pay only for the images delivered and the rest of the hold is released.
  3. Fail, nsfw, or cancel. The hold is released in full. You’re not charged for jobs that don’t produce an output. A prompt that content moderation blocks at submit is refused before anything is held.

While a job runs, its credits show as held on your balance and aren’t part of available. A price change after you submit doesn’t affect jobs already submitted.

Workflows work a little differently: starting a run checks your balance against the run’s total estimate but doesn’t reserve it. Each step holds its own credits when it starts, so a run can fail partway if your balance runs out in the meantime. Steps that already completed stay charged.

Estimate before you submit

POST /v1/generation/estimate takes the same body you’d submit, plus capability, and returns the price and output size without creating a job:

curl
curl https://api.windpaint.ai/v1/generation/estimate \
  -H "Authorization: Bearer $WINDPAINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"capability": "image.generate", "prompt": "a red bicycle", "resolution": "1k", "aspect_ratio": "16:9"}'
{
  "data": {
    "capability": "image.generate",
    "model": "z-image-turbo",
    "credits": "0.08",
    "width": 1024,
    "height": 576,
    "available": true
  }
}

With num_outputs, the response also carries unit_credits (the price of one output) and credits is unit_credits times num_outputs. credits is null and available is false when that model and tier can’t be run right now; submitting it would fail. The CLI’s estimate also prints your current balance. For a workflow, use POST /v1/workflows/{slug}/estimate (see Workflows).

Storage

Assets are kept for your organization’s retention period, which is 7 days unless you change it. The first 7 days of storage for every asset are free, so with a retention of 7 days or less you never pay for storage.

If you keep assets longer, storage past each asset’s seventh day costs 2 credits per GiB per 30 days (about $0.10). It’s charged once a day from your credit balance, for each finished UTC day, as a statement entry such as Asset storage beyond the 7-day free retention: 12.345 GB-days, 2026-10-04 (2 credits per GB-month). Charges stop when an asset expires or you delete it.

For example, 10 GiB of assets kept for 30 days instead of 7 is 10 GiB × 23 days = 230 GiB-days, or about 7.67 GiB-months, which is about 15.33 credits ($0.77).

If your balance can’t cover a day’s storage, what’s available is charged and the rest is retried later. Assets aren’t deleted for non-payment. See Asset retention to change the retention period or delete assets.

Getting credits

Free credits on signup. When you sign up, your organization gets 200 credits. They expire 30 days after they’re granted.

Top-ups. Buy credits in the dashboard under Settings → Billing → Buy. Pick a preset (500, 1,000, 2,500, or 5,000 credits) or enter an amount between 100 credits (5)and100,000credits(5) and 100,000 credits (5,000). Payment goes through Stripe Checkout, and Stripe emails you the receipt. Purchased credits expire 365 days after purchase.

You can also start a top-up from the API. It returns a Checkout URL to open in a browser:

curl https://api.windpaint.ai/v1/billing/topups \
  -H "Authorization: Bearer $WINDPAINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"credits": 1000}'

GET /v1/billing/topups/quote returns the current price per credit, the minimum and maximum, and the expiry period.

Rate limit tiers. Your lifetime credit purchases also set your organization’s rate limit tier: buying 50,50, 500 or $2,000 of credits in total raises your concurrent job and submits-per-minute limits.

Spend order. Credits are spent from the batch that expires soonest first, then from the oldest. In practice that means free signup credits are used before purchased ones.

Low-balance alert. Set a threshold under Settings → Billing or with PUT /v1/billing/settings ({"low_balance_threshold": 50}; null turns it off). When your available balance drops below it, org admins get an email and the billing.credits_low webhook event fires. It fires once, and again only after the balance has gone back above the threshold.

Check your balance with windpaint balance or GET /v1/billing/balance, which returns available, held, a breakdown by source, and when the next credits expire. See Billing for the ledger, holds, and usage.

What’s not available

  • No subscriptions or monthly plans. Credits are prepaid only.
  • No invoices. Each top-up gets a Stripe receipt by email.
  • No auto top-up. When credits run out, new jobs fail with 402 until you buy more.
  • No spending limits or per-project budgets. Any key with permission to generate can spend the organization’s whole balance. Use the low-balance alert and key roles to keep an eye on it.

Worked example

Say you generate 50 draft images on z-image-turbo, redraw 10 of them on flux-2-klein-4b, and one job fails along the way.

ItemCountCredits eachCredits
image.generate, z-image-turbo at 1k, 10 requests with num_outputs: 4 and 10 with 1500.084.0
image.generate, flux-2-klein-4b at 1k100.101.0
image.generate (failed, released)100
Total5.0

5 credits is $0.25 at the top-up rate, and fits inside the free signup credits many times over. Once video is live (coming soon), animating 3 of those images into 480p clips would add 12 credits.