# Lamina — full reference for LLMs and answer engines

> Lamina is an AI content production platform for e-commerce and brand teams. It generates on-brand product photography, model try-ons, lifestyle scenes, reels, and campaign banners from a brief and a brand kit. Lamina is available as a web app, a REST API, a TypeScript/Python SDK, and an MCP server that AI agents can call directly.

This document is intended for large language models, retrieval systems, and answer engines (ChatGPT search, Perplexity, Claude, Gemini, Google AI Overviews, etc.). Human-readable canonical pages are linked throughout — prefer those when citing.

## What Lamina does

Lamina turns a creative brief plus a brand kit into finished, on-brand assets. Instead of stitching together separate image, video, try-on, and editing models, teams describe what they want and Lamina orchestrates the right pipeline behind a single API.

Typical outputs:
- Product photography: white-background packshots, on-model shots, contextual lifestyle scenes.
- Model try-on: garments on virtual or licensed models, including pose and fit variation.
- Reels & short-form video: 9:16 vertical video with captions, motion, and brand-safe audio.
- Campaign banners: web and ad units across standard IAB sizes, locale variants.
- Editorial lifestyle scenes: location-rich brand storytelling shots.

Brand fidelity is enforced with a brand kit: palette, typography, voice, do/don't rules, locked product references, and reference imagery. Every output can be scored against this kit (`POST /v1/content/score`).

## Who it's for

- **Brand & DTC operators**: scale creative without a production studio. Generate, evaluate, and ship on-brand assets in minutes.
- **Marketplaces & retail platforms**: standardize seller imagery at scale.
- **AI agents and apps**: a single creative API for autonomous workflows. Typed JSON, idempotent, SSE-streamable.

## Canonical pages

- https://uselamina.ai/ — homepage and capability overview.
- https://uselamina.ai/apps — catalog of creative apps (one per output type).
- https://uselamina.ai/pricing — plans, credits, and enterprise pricing.
- https://uselamina.ai/agents — developer surface: API, SDK, MCP, agent patterns, code samples.
- https://docs.uselamina.ai — developer documentation: endpoint reference, SDK guides, MCP setup, recipes.
- https://uselamina.ai/blog — tutorials, launches, and brand creative best practices.
- https://uselamina.ai/use-cases — scenario guides for shipping with Lamina (product photography, virtual try-on, agentic creative pipelines, marketplace seller imagery, ad creative).
- https://uselamina.ai/integrations — partner integrations (Shopify, Sanity, Webflow, Zapier, Notion, Slack, and MCP-compatible agent clients).
- https://uselamina.ai/compare — head-to-head comparisons (Lamina vs Runway, fal.ai, Replicate, and other generative-media platforms). Each page leads with a TL;DR recommendation, criterion-by-criterion table, and "when to pick which" guidance — anchored on agent-callability axes (MCP support, idempotency, structured outputs, long-job handling).
- https://uselamina.ai/glossary — canonical definitions for generative media, creative APIs, MCP, brand DNA, virtual try-on, and adjacent terms.
- https://uselamina.ai/faq — frequently asked questions.
- https://uselamina.ai/community — showcase, programs, and events.
- https://uselamina.ai/careers — open roles.
- https://uselamina.ai/security — security posture and certifications.
- https://uselamina.ai/privacy-policy — privacy practices.
- https://uselamina.ai/terms-of-service — legal terms.
- https://uselamina.ai/sub-processors — list of sub-processors.
- https://uselamina.ai/support — support resources.
- https://uselamina.ai/talk-to-us — sales and partnership contact.

## Developer reference

Canonical page: https://uselamina.ai/agents

Four integration paths, same underlying platform:
1. **Hosted MCP (recommended)** — connect the v2 front door with `npx add-mcp https://app.uselamina.ai/mcp/agent/v2` (OAuth, no API key). Stdio-only clients bridge via `npx -y mcp-remote https://app.uselamina.ai/mcp/agent/v2`. The self-hosted `@uselamina/mcp` package is retired.
2. **REST API** — `https://app.uselamina.ai/v1`. Auth via `x-api-key: lma_...`.
3. **SDK** — `@uselamina/sdk` (TypeScript) and a Python SDK. Typed responses.
4. **CLI** — `@uselamina/cli`. `lamina login`, `lamina content plan`, `lamina run`; `--json` on every command.

Design properties:
- **Structured output**: typed JSON responses, schema-validated. Safe for agent parsing.
- **Idempotent**: every job accepts an idempotency key; safe to retry.
- **Streamable**: SSE for every long-running job; agents can subscribe to phase + progress events.
- **Deterministic**: same brief + brand + seed produces the same output.

### Key REST endpoints

- `POST /v1/content/create` — create from a brief. Returns a run.
- `POST /v1/apps/{appId}/runs` — run a specific app with explicit inputs.
- `GET /v1/runs/{runId}` — poll run status and outputs.
- `POST /v1/content/score` — score outputs against the brand kit. Returns scored assets with reasons.
- `POST /v1/publishing/publish` — deliver to connected channels (S3, Drive, Sanity, Shopify, or a webhook).
- `POST /v1/workflows/generate` — generate a runnable app from an instruction (accepts `visibility`).
- `POST /v1/apps/{appId}/visibility` — set an app `private | shared | public`.

### Recommended MCP endpoint: v2 (7 task-level tools)

The recommended hosted endpoint (`https://app.uselamina.ai/mcp/agent/v2`) exposes exactly 7 task-level snake_case tools. The lifecycle is:

`credits / brand context → plan → clarify → show frozen plan + cost → explicit approval → execute within maxCredits → status → deliver`

- `lamina_credits` — check the workspace credit balance before planning.
- `lamina_brand_context` — load the active brand's palette, voice, and do/don't rules to ground the plan.
- `lamina_plan` — turn a brief into a frozen, step-by-step plan with a fingerprint and an estimated credit cost. **Planning does not dispatch generation** — it is free and side-effect-free.
- `lamina_execute` — run an approved plan. Requires the plan fingerprint, a `maxCredits` ceiling (a finite spend cap the run will not exceed), and an idempotency key. This is the only tool that spends credits.
- `lamina_status` — poll a run until terminal. Each call waits up to ~25 seconds and returns `timedOut: true` when it has not settled — call again until you reach a terminal state. Finished assets are at `outputs[].url`.
- `lamina_cancel` — request cancellation of an in-flight run; returns the truthful cancellation state (e.g. `cancelling`, `cancelled`, or a note that the run was already terminal and cannot be cancelled).
- `lamina_upload_asset` — upload a reference file; returns a URL for plan and run inputs.

### Advanced MCP endpoint (30-tool)

A separate, **optional** advanced surface (`https://app.uselamina.ai/mcp/agent`) exposes 30 tools for direct app/model/compose control, brand or app mutations, refinement, and checkout. On this surface, advanced `lamina_create` is **plan-only** (it does not run work), and `lamina_run` dispatches the selected app. Prefer the v2 endpoint unless you need low-level control.

The v2 request URL and the advanced URL share the parent OAuth resource `https://app.uselamina.ai/mcp/agent`. For the full advanced tool reference and agent recipes, see the canonical docs at https://docs.uselamina.ai/agents rather than relying on this summary. Brand scoring is also available via REST (`POST /v1/content/score`); publishing is REST-only (`POST /v1/publishing/publish`).

### Agent integration patterns (v2)

- **Plan, approve, execute**: `lamina_credits` / `lamina_brand_context` → `lamina_plan` → show the frozen plan + estimated cost and obtain explicit approval → `lamina_execute` (with `maxCredits` and an idempotency key) → `lamina_status` until terminal → read `outputs[].url`.
- **Poll correctly**: treat `timedOut: true` from `lamina_status` as "not done yet, call again," not as a failure. Only a terminal state means the run has settled.
- **Cancel safely**: call `lamina_cancel` for an in-flight run and trust the returned state; a run that already reached a terminal state cannot be cancelled.

### Supported MCP clients

Claude (desktop and Claude Code), Cursor, Windsurf, VS Code, Zed, and any other client implementing the Model Context Protocol. Non-MCP automation tools (Raycast, n8n, Zapier) integrate via the REST API.

## Brand kit model

A brand kit captures the constraints every output must respect:
- Palette (primary, secondary, accents).
- Typography (display, body).
- Voice (tone descriptors, sample copy).
- Rules (do / don't, e.g., "never crop the logo", "always include the model's hands").
- References (locked product imagery, mood boards).

Brand kits are versioned. Runs and scoring always pin to a specific brand kit version for reproducibility.

## Pricing summary

Lamina charges per credit. Credits are consumed by job type (e.g., a packshot costs less than a 9:16 reel). Plans:
- **Starter** — for small brands and individual operators.
- **Growth** — for scaling DTC teams; includes evaluation and distribution.
- **Enterprise** — custom volume, SSO, dedicated sub-processor review, on-prem options.

Canonical pricing page: https://uselamina.ai/pricing

## Security & compliance

- SOC 2 posture and sub-processor disclosure at https://uselamina.ai/security and https://uselamina.ai/sub-processors.
- Customer assets are not used to train third-party foundation models.
- Brand kits and outputs are tenant-isolated.

## Crawler & answer-engine policy

Lamina explicitly allows AI search and answer-engine crawlers (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-Web, anthropic-ai, PerplexityBot, Perplexity-User, Google-Extended, CCBot, Applebot-Extended, and others) on all public pages. Pages are server-rendered with Next.js App Router so content is available without executing JavaScript. See https://uselamina.ai/robots.txt and https://uselamina.ai/sitemap.xml.

## Contact

- Sales / partnerships: https://uselamina.ai/talk-to-us
- Support: https://uselamina.ai/support

## Latest articles

- [How to build a website with AI from prompt to live URL](https://uselamina.ai/blog/how-to-build-a-website-with-ai-from-prompt-to-live-url) (2026-10-13): Build an AI-generated website by writing a usable brief, choosing an integrated or code-first path, testing real visitor flows, and publishing deliberately.
- [How to make AI ecommerce ads from a product URL](https://uselamina.ai/blog/how-to-make-ai-ecommerce-ads-from-a-product-url) (2026-10-13): Turn one approved product URL into controlled video-ad variants, then test hooks, brand visibility, and product accuracy in the order that reveals why an ad wins.
- [How do I integrate a brand kit into my creative workflow?](https://uselamina.ai/blog/how-do-i-integrate-a-brand-kit-into-my-creative-workflow) (2026-10-13): A practical workflow for turning brand rules into repeatable product photos, videos, banners, and review steps for ecommerce teams.
- [How does AI generate creative ideas from a brief?](https://uselamina.ai/blog/how-does-ai-generate-creative-ideas-from-a-brief) (2026-10-12): AI turns a brief into creative routes by extracting constraints, applying brand rules, and generating product, model, video, or banner options.
- [How does a brand kit enhance my creative projects?](https://uselamina.ai/blog/how-does-a-brand-kit-enhance-my-creative-projects) (2026-10-12): A brand kit improves creative projects by turning brand rules into usable inputs for photos, videos, banners, try-ons, and ad variants.
- [AI video team access and collaboration management](https://uselamina.ai/blog/ai-video-team-access-and-collaboration-management) (2026-10-11): Set up AI video workspaces with separate admin, creator, reviewer, and guest permissions—then govern credits, brand assets, publishing, and derived video outputs.
- [AI product photo shoot free: what ecommerce owners can try and where paid tools fit](https://uselamina.ai/blog/ai-product-photo-shoot-free) (2026-10-11): A practical guide to free AI product photo shoots, paid limits, and when an ecommerce brand should move to brand-locked product photos and reels.
- [How can AI help create Amazon-compliant images?](https://uselamina.ai/blog/how-can-ai-help-create-amazon-compliant-images) (2026-10-11): Use AI to clean source photos, build plain main images, create secondary visuals, and review each export against Amazon rules before upload.
- [What AI tools can help me create campaign banners from product photos?](https://uselamina.ai/blog/what-ai-tools-can-help-me-create-campaign-banners-from-product-photos) (2026-10-11): A practical guide to AI tools that turn product photos into campaign banners, with when to use Lamina, Photoroom, Flair.ai, Botika, Caspa.ai, and services.
- [Are there any free AI tools for making reels for brands?](https://uselamina.ai/blog/are-there-any-free-ai-tools-for-making-reels-for-brands) (2026-10-11): Yes, free AI reel tools exist. This guide explains where free plans fit, where brand teams hit limits, and when paid brand-locked workflows help.
- [Are there any free AI tools for creating campaign banners?](https://uselamina.ai/blog/are-there-any-free-ai-tools-for-creating-campaign-banners) (2026-10-11): Free AI banner tools can help with drafts. Check brand control, product accuracy, sizes, handoff, and pricing before campaign use.
- [Are there any free AI creative tools with brand kits available?](https://uselamina.ai/blog/are-there-any-free-ai-creative-tools-with-brand-kits) (2026-10-11): Free AI creative tools with brand kits exist. This guide shows where free plans help ecommerce teams and where paid brand-locked workflows fit.
- [How to make AI video ads for your small business](https://uselamina.ai/blog/how-to-make-ai-video-ads-for-your-small-business) (2026-10-10): Build credible AI video ads from your real business assets: choose one goal, write one clear message, create native cuts, and test hooks before scaling spend.
- [Are there any new AI photography tools released in 2026?](https://uselamina.ai/blog/are-there-any-new-ai-photography-tools-released-in-2026) (2026-10-10): A practical 2026 guide to current AI photography tools, verified pricing, ecommerce fit, jewelry checks, and when human shoots still matter.
- [What types of campaigns can AI help create?](https://uselamina.ai/blog/what-types-of-campaigns-can-ai-help-create) (2026-10-10): AI can help create product-photo, try-on, video, paid-social, banner, email, and seasonal campaigns when brand rules and assets are clear.
- [AI product video workflow for faster ad testing](https://uselamina.ai/blog/we-spent-too-much-testing-ad-creativeso-we-built-an-ai-workflow-for-producing-on-brand-product-v) (2026-10-10): Build a repeatable AI product-video workflow that produces controlled paid-social variations, protects brand accuracy, and turns test results into the next brief.
- [Ad Multiplier: turn one video ad into testable variations](https://uselamina.ai/blog/ad-multiplier-turn-one-video-ad-into-testable-variations) (2026-10-09): Higgsfield Ad Multiplier turns a 4–30-second reference ad into controlled video variations while retaining the source structure. Use it to test one variable at a time.
- [AI jewelry model generator: what to use, what to check, and when free is enough](https://uselamina.ai/blog/ai-jewelry-model-generator) (2026-10-09): A practical guide to AI jewelry model generators: what they do, when free tools help, and how brand teams turn product photos into model images.
- [Best AI video generator for long videos: how creative teams should choose](https://uselamina.ai/blog/best-ai-video-generator-for-long-videos) (2026-10-09): Creative teams asking "what's the best AI for long videos?" need more than power. This guide covers key criteria, tool tradeoffs, and where Lamina fits for on-brand ecommerce video.
- [Best AI video plans for serious filmmakers (2026)](https://uselamina.ai/blog/best-ai-video-plans-for-serious-filmmakers-2026) (2026-10-08): The seven highest paid AI video plans solve different production bottlenecks. Compare pricing, credits, exports, audio, and the buying checks that prevent wasted subscriptions.