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

# Cherry Shot for Agencies: White-Label Workspace Guide

> Run Cherry Shot under your own brand: shared credit pool, per-client attribution, branded delivery galleries, and agency-only API endpoints for devs.

Cherry Shot's white-label program gives your agency a dedicated workspace built on top of the same generation engine used by every other Cherry Shot customer. Your team creates product shoots and video ads — in the app or over the API — while your clients see only your brand. Usage is tracked per client from day one, so you always know exactly what to invoice and where your credits are going.

## Workspace structure

Your agency workspace is organized around four concepts:

| Concept              | What it is                                                                                                                                         |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Agency**           | Your organization. It holds a shared **credit pool** that every team member draws from — no per-seat balances to manage or reconcile.              |
| **Client brands**    | Your e-commerce clients (e.g., "Acme Apparel"). Every shoot and video is attributed to one brand, giving you clean per-client billing reports.     |
| **Members**          | Your team's Cherry Shot accounts, linked to the agency. Each member selects which client they are currently working for via a switcher in the app. |
| **Review galleries** | Branded, read-only share links for client approval — your logo and colors, no Cherry Shot branding, and no client login required.                  |

## Billing

Everything your team generates — in the app or over the API, images or video — draws the shared agency credit pool. There is no separate balance per seat or per brand.

* Failed or partial generations auto-refund the pool automatically, the same as regular accounts.
* `GET /v1/credits` on an agency key returns the pool balance (the `balance` field will read `"pool"`).
* `GET /v1/usage` breaks the current billing period down by client brand.

```bash theme={null}
curl "https://kyliwpyuseadbwawnsyd.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 }
}
```

Pool top-ups are invoiced monthly at your plan's wholesale rate. Contact your account manager to adjust your pool size or switch billing cadences.

## Attributing work to a client

**In the app:** your Profile includes an agency panel with a **"Working for"** switcher. Every shoot or video you start after switching is tagged to the selected client brand automatically.

**Over the API:** create one API key per client brand — either through **Profile → API** (pick the brand from the dropdown) or programmatically via `POST /v1/brands` followed by key creation. Everything generated with a brand-specific key is attributed to that brand with no extra steps required.

## Branded galleries

From the agency panel, select any set of generated shots and create a **gallery link** — the URL takes the form `/g/<token>`. When your client opens the link, they see your logo, your accent color, the chosen images, and download buttons. There is no Cherry Shot branding anywhere on the page, and clients do not need a Cherry Shot account to view or download.

Gallery links are revocable at any time from the agency panel — the token stops working immediately.

<Tip>
  Set your logo and accent color once in the agency panel (owners only). Every gallery you
  share — past and future — picks up the latest branding immediately.
</Tip>

## Agency-only API endpoints

Agency keys unlock three additional endpoints on top of the [standard Cherry Shot API](/quickstart):

* `GET /v1/usage` — per-brand usage breakdown for invoicing
* `GET /v1/brands` / `POST /v1/brands` — list and create client brands programmatically
* `GET /v1/credits` — retrieve the shared pool balance

All other endpoints — [shoots](/guides/shoots), [videos](/guides/videos), [MCP](/guides/mcp) — work identically to regular accounts and bill to the shared 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** | —        | —          | ✓           |

To get started, email [simplifygenai@gmail.com](mailto:simplifygenai@gmail.com?subject=CherryShot%20Agency%20Partnership) with your agency name and the clients you would start with. The first five agencies to sign up receive **founding-partner terms: 40% off the platform fee for six months and a wholesale credit rate locked for a year**, in exchange for a short case study.