Skip to main content

API Reference

Credits & Billing

Credits power every operation on floow.design. Each API call deducts credits from your balance. This page explains how credits work, what each plan includes, and how to buy more when you need them.

How credits work

Deducted per call

Each time you call an endpoint — like Image → HTML or Export Code — credits are deducted from your balance automatically.

Reset on billing date

Plan credits refresh every billing cycle (monthly or yearly). Any unused plan credits are forfeited — they do not roll over.

Packs never expire

Credit packs are a one-time purchase. They stack on top of your plan's monthly credits and never expire.

What each plan includes

The Free plan gives you 150 one-time credits to explore the platform — these are not renewed each month and do not include API access. To use the API, you need a paid plan.

PlanCreditsResetsAPI accessBuy more
Freeplatform only150One-time——
Lite2,000 / moMonthly✓✓
Starter8,000 / moMonthly✓✓
Pro40,000 / moMonthly✓✓
Team60,000 / seat / moMonthly✓✓

Need more credits?

Use the estimator below to figure out how many credits you need, then buy a pack in one click. Credit packs are available on Lite and above — they never expire and stack on top of your plan.

Estimate your monthly usage

30 crImage → HTML
calls

= 1,500 credits

15 crExport Code
calls

= 750 credits

10 crFigma Export
calls

= 200 credits

Total estimated credits / month2,450

Credit packs— one-time purchase, never expires

Starter Pack

$9

1,000 credits

Recommended

Growth Pack

$39

5,000 credits

✓ Covers your estimate

Scale Pack

$139

20,000 credits

✓ Covers your estimate

Enterprise Pack

$599

100,000 credits

✓ Covers your estimate

Credits are added to your account immediately after payment. Requires Lite plan or higher.

Buy a credit pack via API

You can also trigger a purchase programmatically. The endpoint returns a Stripe checkout URL — redirect your user to it to complete payment. Credits are added to the account as soon as payment succeeds.

POST/api/v1/credits/purchase🔑 Auth required

Create a Stripe checkout session for a credit pack. Returns a one-time checkout URL to redirect your user to.

  • Requires Lite plan or higher. Returns 403 with upgrade: true if the account is on the Free plan.
  • The url is a one-time Stripe Checkout link. Redirect the user's browser to it to complete payment.
  • Credits are added permanently — no expiry date.

Body Parameters

NameTypeDescription
pack"credits_1000" | "credits_5000" | "credits_20000" | "credits_100000"The ID of the credit pack to purchase.
Response
{  "url": "https://checkout.stripe.com/c/pay/...",  "pack": {    "id": "credits_5000",    "name": "Growth Pack",    "credits": 5000,    "price": "$39"  }}
curl https://www.floow.design/api/v1/credits/purchase \  -X POST \  -H "Authorization: Bearer fl_your_api_key" \  -H "Content-Type: application/json" \  -d '{ "pack": "credits_5000" }'
const res = await fetch("https://www.floow.design/api/v1/credits/purchase", {  method: "POST",  headers: {    Authorization: "Bearer fl_your_api_key",    "Content-Type": "application/json",  },  body: JSON.stringify({ pack: "credits_5000" }),});
const data = await res.json();
if (!res.ok) {  if (data.upgrade) {    // Account is on Free or Lite — must upgrade to Starter first    console.log("Upgrade required:", data.error);  } else {    throw new Error(data.error);  }}
// Redirect the user to Stripe to complete paymentwindow.location.href = data.url;
import requests
res = requests.post(    "https://www.floow.design/api/v1/credits/purchase",    headers={        "Authorization": "Bearer fl_your_api_key",        "Content-Type": "application/json",    },    json={"pack": "credits_5000"},)
data = res.json()
if res.status_code == 403 and data.get("upgrade"):    print("Upgrade required:", data["error"])else:    res.raise_for_status()    # Redirect your user to data["url"] to complete payment    print("Checkout URL:", data["url"])

Available packs

Pack IDNameCreditsPrice
credits_1000Starter Pack1,000$9
credits_5000popularGrowth Pack5,000$39
credits_20000Scale Pack20,000$139
credits_100000Enterprise Pack100,000$599