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

# Lamina

> The generative media platform for AI agents. Create product images, videos, virtual try-on, and more through MCP, REST API, or CLI.

The generative media platform for AI agents. You call apps — not models. Lamina handles orchestration, brand context, quality scoring, and multi-channel publishing.

<Frame>
  <iframe width="100%" height="400" src="https://www.youtube.com/embed/4HDJcl1WWYY" title="Lamina in action" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

<CardGroup cols={3}>
  <Card title="30+ creative apps" icon="grid-2">
    Image gen, video, try-on, compositing, upscaling, and more
  </Card>

  <Card title="5 MCP tools" icon="plug">
    Native agent integration with OAuth
  </Card>

  <Card title="15+ AI clients" icon="robot">
    Claude, Cursor, Windsurf, VS Code, and more
  </Card>
</CardGroup>

## Choose Your Path

<CardGroup cols={3}>
  <Card title="MCP Server" icon="bolt" href="/guides/mcp-oauth-install">
    Give your AI agent creative superpowers. Connect via OAuth — no API keys to manage.
  </Card>

  <Card title="REST API" icon="code" href="/quick-start">
    Build generative media into your product. Full control over creation, scoring, and distribution.
  </Card>

  <Card title="CLI" icon="terminal" href="/guides/use-the-cli-and-sdk">
    Run creative workflows from your terminal. Ideal for scripting and local development.
  </Card>
</CardGroup>

## Get Started in One Line

<CodeGroup>
  ```bash MCP (Agents) theme={null}
  npx add-mcp https://app.uselamina.ai/mcp/agent
  ```

  ```bash REST API theme={null}
  curl -X POST -H "x-api-key: lma_your_api_key" -H "Content-Type: application/json" \
    -d '{"brief": "Product hero shot of white sneakers, premium lighting"}' \
    https://app.uselamina.ai/v1/content/create
  ```

  ```bash CLI theme={null}
  npm install -g @uselamina/cli
  ```
</CodeGroup>

## What You Can Generate

<CardGroup cols={3}>
  <Card>
    <img src="https://cdn.sanity.io/images/nxxnxyyr/production/20a6d32531d3b2a5d9cbdd20e5dcd50fe49964d5-1024x1024.jpg?auto=format&fit=max&q=75" alt="Product Shoots" />

    **Product Shoots** — Hero shots, lifestyle scenes, catalog-ready assets
  </Card>

  <Card>
    <img src="https://cdn.sanity.io/images/nxxnxyyr/production/65eea9de797a81786ff7c6fab8b08f08a7865c61-800x1000.jpg?auto=format&fit=max&q=75" alt="Virtual Try-On" />

    **Virtual Try-On** — Garment-on-model from shopper photos
  </Card>

  <Card>
    <img src="https://cdn.sanity.io/images/nxxnxyyr/production/942f807749bcd6ecbdbfef611c30b78da01dfc1a-1920x1080.jpg?auto=format&fit=max&q=75" alt="Campaign Banners" />

    **Campaign Banners** — Multi-format ads and social banners
  </Card>

  <Card>
    <img src="https://cdn.sanity.io/images/nxxnxyyr/production/38d98d8dca4b633d8135de9c8ee64e2eccfa348d-1080x1920.jpg?auto=format&fit=max&q=75" alt="Instagram Reels" />

    **Video & Reels** — Short-form video and product animations
  </Card>

  <Card>
    <img src="https://cdn.sanity.io/images/nxxnxyyr/production/81940a40ac0879d7d10322b523ce5a2b30eba305-800x1000.jpg?auto=format&fit=max&q=75" alt="Ad Variants" />

    **Ad Variants** — A/B creative variants at scale
  </Card>

  <Card>
    <img src="https://cdn.sanity.io/images/nxxnxyyr/production/0a68f5d0169cb18a0dd299afeb635e331adc60c9-1920x1080.jpg?auto=format&fit=max&q=75" alt="Brand Films" />

    **Brand Films** — Cinematic content and storyboards
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Create">
    Use `POST /v1/content/create` for intent-driven creation, or `POST /v1/apps/{appId}/runs` for precise control. Both return a run ID immediately.
  </Step>

  <Step title="Track">
    Receive results via webhook callback, SSE stream, wait endpoint, or poll `GET /v1/runs/{runId}`.
  </Step>

  <Step title="Evaluate">
    Score outputs with `POST /v1/content/score` for quality and brand alignment signals.
  </Step>

  <Step title="Distribute">
    Publish via `POST /v1/publishing/publish` to connected channels, or transfer assets to your CDN.
  </Step>
</Steps>

## Built for AI Agents

If you are building with Claude, GPT, LangChain, or any agent framework, Lamina is designed for programmatic consumption from the ground up.

* **Schema-first** — Every app has a discoverable, typed input contract. Agents can inspect inputs before calling.
* **Async-native** — Executions return immediately. Results arrive via webhook, SSE, or long-poll — no blocking.
* **Intelligence-grounded** — Brand context, performance predictions, and trend data are all API-accessible.
* **One-call creation** — `POST /v1/content/create` goes from intent to asset without manual orchestration.
* **MCP-native** — Connect as a remote MCP server with OAuth. No key pasting, no tool configuration.

Read [The Creative Engine](/concepts/creative-engine) for the full mental model. For machine-readable specs, fetch [`/llms.txt`](/llms.txt).

## Authentication

All endpoints use a workspace-scoped API key.

```http theme={null}
x-api-key: lma_your_api_key
```

or:

```http theme={null}
Authorization: Bearer lma_your_api_key
```

MCP connections use OAuth instead — see [MCP OAuth Install](/guides/mcp-oauth-install).

Read [Authentication](/authentication) for the full model.

## Start Building

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quick-start">
    Create your first asset in under 5 minutes
  </Card>

  <Card title="The Creative Engine" icon="engine" href="/concepts/creative-engine">
    Understand the mental model behind Lamina
  </Card>

  <Card title="Apps and Executions" icon="play" href="/concepts/apps-and-executions">
    How apps, runs, and outputs fit together
  </Card>

  <Card title="Agent Integration Patterns" icon="robot" href="/guides/agent-integration-patterns">
    Patterns for building agent workflows with Lamina
  </Card>

  <Card title="Capability Recipes" icon="book" href="/guides/capability-recipes">
    Common integration patterns and recipes
  </Card>

  <Card title="API Reference" icon="rectangle-terminal" href="/api-reference/list-apps">
    Full endpoint documentation
  </Card>
</CardGroup>
