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

# Agencies & white-label

> Run Cherry Shot under your agency's brand: shared credit pool, per-client billing, branded delivery.

Cherry Shot's white-label program gives your agency its own workspace on top of the same
engine: your team generates in the app or over the API, your **clients only ever see your
brand**, and usage is tracked **per client** so you know exactly what to invoice.

## How an agency workspace is structured

| Concept              | What it is                                                                                                           |
| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Agency**           | Your organization. Has a shared **credit pool** every member bills against — no per-seat balances to manage.         |
| **Client brands**    | Your e-commerce clients (e.g. "Acme Apparel"). Every shoot and video is attributed to one, for billing reports.      |
| **Members**          | Your team's Cherry Shot accounts, linked to the agency. In the app they pick which client they're working for.       |
| **Review galleries** | Branded, read-only share links for client approval — your logo and colors, no Cherry Shot branding, no client login. |

## Billing: one pool, per-client attribution

* Everything your team generates — app or API, images or video — draws the **agency pool**.
  Failed or partial generations auto-refund the pool, same as regular accounts.
* `GET /v1/credits` on an agency key returns the pool balance (`"balance": "pool"`).
* `GET /v1/usage` breaks the month down per client brand:

```bash theme={null}
curl "https://ybhqmgyprapjxomdxifs.supabase.co/functions/v1/api/v1/usage" \
  -H "Authorization: Bearer cs_your_agency_key"
```

```json theme={null}
{
  "object": "usage_report",
  "period": { "from": "2026-07-01T00:00:00Z", "to": "now" },
  "data": [
    { "brand_name": "Acme Apparel", "images": 84, "image_credits": 96, "videos": 3, "video_credits": 45 },
    { "brand_name": "Nordic Home", "images": 40, "image_credits": 40, "videos": 0, "video_credits": 0 }
  ],
  "totals": { "images": 124, "videos": 3, "credits": 181 }
}
```

Top-ups are invoiced monthly at your plan's wholesale rate — contact your account manager
to adjust the pool.

## Attributing work to a client

**In the app:** your Profile has an agency panel with a **"Working for"** switcher — every
generation after switching is tagged to that client.

**Over the API:** create one key per client brand (`Profile → API`, pick the brand — or
`POST /v1/brands` + key creation). Everything generated with that key is attributed to
that brand automatically.

## Branded client galleries

From the agency panel, select any generated shots and create a **gallery link**
(`/g/<token>`). Your client sees your logo, your accent color, the shots, and download
buttons — nothing else. Links are revocable at any time.

<Tip>
  Set your logo and accent color once in the agency panel (owners only) — every gallery you
  share uses them immediately.
</Tip>

## API access for your dev team

Agency keys unlock three extra endpoints on top of the [regular API](/quickstart):

* `GET /v1/usage` — per-brand usage for invoicing
* `GET /v1/brands` / `POST /v1/brands` — manage client brands programmatically
* `GET /v1/credits` — the shared pool balance

Everything else — [shoots](/guides/shoots), [videos](/guides/videos), [MCP](/guides/mcp) —
works identically, billed to the pool.

## Plans

|                                  | Partner  | Agency Pro | Enterprise  |
| -------------------------------- | -------- | ---------- | ----------- |
| Monthly                          | \$299    | \$799      | Custom      |
| Client brands                    | 3        | 10         | Unlimited   |
| Credits included                 | 1,000/mo | 3,000/mo   | 10,000+/mo  |
| Extra credits                    | \$0.30   | \$0.25     | from \$0.20 |
| Branded galleries                | ✓        | ✓          | ✓           |
| Per-brand keys & branded docs    | —        | ✓          | ✓           |
| Fully branded app on your domain | —        | —          | ✓           |

Want in? Email [simplifygenai@gmail.com](mailto:simplifygenai@gmail.com?subject=CherryShot%20Agency%20Partnership)
with your agency name and the clients you'd start with. The first five agencies get
founding-partner terms: **40% off the platform fee for six months** and a wholesale rate
locked for a year, in exchange for a case study.