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

# How IU billing works

> What an Intelligence Unit pays for, what stays free, the plans, and a calculator for your month.

export const IuCalculator = () => {
  const [buys, setBuys] = useState(6);
  const [briefs, setBriefs] = useState(40);
  const ius = Math.max(0, Number(buys) || 0) + Math.max(0, Number(briefs) || 0);
  const plans = [{
    name: 'Metered',
    fee: 0,
    included: 0
  }, {
    name: 'Committed 250',
    fee: 1000,
    included: 250
  }, {
    name: 'Committed 1,000',
    fee: 3000,
    included: 1000
  }];
  const usd = n => '$' + n.toLocaleString('en-US');
  return <div className="not-prose" style={{
    border: '1px solid rgba(127,127,127,0.3)',
    borderRadius: 12,
    padding: 16
  }}>
      <label style={{
    display: 'block',
    marginBottom: 8
  }}>
        Media buys with spend this month (non-social):{' '}
        <input type="number" min="0" value={buys} onChange={e => setBuys(e.target.value)} style={{
    width: 90
  }} />
      </label>
      <label style={{
    display: 'block',
    marginBottom: 12
  }}>
        Brief responses by your storefront agent this month:{' '}
        <input type="number" min="0" value={briefs} onChange={e => setBriefs(e.target.value)} style={{
    width: 90
  }} />
      </label>
      <p style={{
    margin: '0 0 8px'
  }}>
        <strong>{ius}</strong> IUs this month.
      </p>
      <ul style={{
    margin: 0
  }}>
        {plans.map(p => <li key={p.name}>
            {p.name}:{' '}
            {p.included === 0 ? `${usd(ius * 5)} at $5 per IU` : ius <= p.included ? `${usd(p.fee)}, with ${p.included - ius} included IUs to spare` : `${usd(p.fee)} plus ${ius - p.included} IUs over the included ${p.included}`}
          </li>)}
      </ul>
    </div>;
};

Semicola takes **0% of media**. It charges for intelligent work, measured in **Intelligence Units
(IUs)**. Every price is published on the rate card before you act, so nothing meters silently.

## What costs IUs

| Activity                        | Price                  | When it is charged                                                         |
| ------------------------------- | ---------------------- | -------------------------------------------------------------------------- |
| Media buy billing period        | 1 IU                   | Once per billing period for each non-social media buy that had spend.      |
| Storefront agent brief response | 1 IU                   | Each time a hosted storefront agent finishes a response (ready or passed). |
| Generated image                 | Published on rate card | Each image generated for a creative.                                       |
| Assistant support session       | Calibrating            | Not charged while calibrating.                                             |
| Document understanding          | Calibrating            | Not charged while calibrating.                                             |

An activity marked **calibrating** is being measured and cannot debit your balance.

## What stays free

* Listing your own storefront.
* Connecting to sellers, discovering products and mapping accounts.
* Requesting proposals from sellers. (The seller's storefront agent response is billed to the seller.)
* Reading delivery and reports.

## Plans

| Plan                | Monthly fee | Included IUs | Beyond the included IUs          |
| ------------------- | ----------- | ------------ | -------------------------------- |
| **Metered**         | none        | none         | \$5 per IU                       |
| **Committed 250**   | \$1,000     | 250          | Billed at the plan's usage price |
| **Committed 1,000** | \$3,000     | 1,000        | Billed at the plan's usage price |

Custom plans are available for larger organizations. New organizations receive a one-time grant of
setup IUs that expires a set number of days after signup. Committed plans can roll a capped share of
unused IUs into the next period.

## Worked examples

**A buyer running six campaigns.** Six non-social media buys had spend this month: 6 IUs. On the
metered plan that is \$30.

**A publisher answering briefs.** The storefront agent answered 180 briefs and the storefront had no
buys of its own: 180 IUs. Metered costs $900; Committed 250 costs $1,000 and leaves 70 IUs to spare.

## Calculator

<IuCalculator />

## Where to see it

**Settings → Plan & billing** shows the balance, IUs used this period, projected month-end usage, the
published price list and any next step, such as accepting terms or adding a payment method. Billing
is managed by organization admins; child accounts see "Billing is handled at the organization level".
