> ## 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. # List Compose Formats > List the video **formats** `POST /v1/compose/video` can render — animated slideshow, cinematic b-roll, motion-graphics explainer, and more. Each format renders differently and internally uses different models; **callers pick a format (never a model) and see its cost.** The response also returns fixed **capabilities** (max script length, supported aspect ratios, clip window) so an agent can construct any valid compose call from a single discovery request. Formats with `available: false` are on the roadmap and cannot be dispatched yet. Formats may declare required `inputs` (e.g. a presenter image) that must be supplied. The menu `POST /v1/compose/video` renders from. Each **format** is a named look — animated slideshow, cinematic b-roll, motion-graphics explainer, and more — that internally uses different models. You pick a **format**, never a model, and see its cost. The response also returns fixed **capabilities** (max script length, aspect ratios, clip window) so you can build any valid compose call from this one request. Formats with `available: false` are on the roadmap. A format may declare required `inputs` (e.g. a presenter image) you must supply when you dispatch it. ## OpenAPI ````yaml GET /v1/compose/formats openapi: 3.1.0 info: title: Lamina Apps API version: 1.0.0 description: > Professional creative content production for AI agents. Create brand-aligned images, videos, and designs from natural-language briefs using 30+ specialized AI pipelines. Unlike raw model APIs (DALL-E, Flux, Kling), Lamina automatically applies brand guidelines, selects the optimal multi-model pipeline, scores output quality, and delivers permanent CDN-hosted URLs with composability metadata for chaining. ## Authentication All endpoints require an API key passed via one of these headers: - `x-api-key: lma_your_key` (recommended) - `Authorization: Bearer lma_your_key` API keys are workspace-scoped. Create them in **Settings -> API Keys**. ## Quick Start (One-Call Path) `POST /v1/create` with `{ "brief": "product photo of sneakers", "sync": true }` — returns completed output inline with CDN URL. ## Quick Start (Advanced) 1. `GET /v1/apps` -- browse 30+ specialized creative apps 2. `GET /v1/apps/{appId}` -- inspect input parameters 3. `POST /v1/apps/{appId}/runs?webhook=` -- run with your inputs 4. Receive results via webhook, poll `GET /v1/runs/{runId}`, or stream via `GET /v1/runs/{runId}/stream` ## Rate Limits All `/v1/*` endpoints are currently limited to 100 requests per minute per IP. On `429`, read the `RateLimit-*` and `Retry-After` headers before retrying. ## How Inputs Work When running an app, provide inputs as a JSON object keyed by parameter **name** (from the app details response). - **text** parameters: send a string value (e.g. a prompt or description) - **options** parameters: send the **label** of the option (e.g. `"Caucasian"`), not an internal value - **url** parameters: send a publicly accessible URL to an image or video Every parameter is returned with `required: true`. Parameters with a `default` can safely be omitted -- the app will use the default value. ## Endpoint Groups | Group | Purpose | |-------|---------| | **Apps** | Discover and inspect available content creation apps | | **Runs** | Run workflows, track progress, and retrieve results | | **Assets** | Browse generated images, videos, and text from past executions | | **Intelligence** | Brand context, performance prediction, recommendations, and trends | | **Publishing** | Publish content to connected social channels | | **Content** | One-call agent operations: create, score, brief, batch | | **Account** | Credit balance and rate limit visibility | | **Templates** | Content creation templates and strategies | | **Webhooks** | Webhook signature verification | servers: - url: https://app.uselamina.ai description: Production security: - apiKey: [] tags: - name: Create description: Create content from briefs, run specific apps, and use templates - name: Discover description: Find and inspect available apps and their input schemas - name: Track description: Monitor execution progress, retrieve results, and browse generated assets - name: Intelligence description: >- Brand context, performance prediction, content recommendations, and trend signals - name: Distribute description: Publish content to social channels and transfer assets to CDN - name: Score description: Evaluate content quality, brand alignment, and engagement potential - name: Compose description: >- Turn a script into a narrated, multi-shot video — pick a format (never a model), preview cost, and render - name: Account description: Credit balance, rate limits, and health checks - name: Webhooks description: Webhook signature verification for secure callback handling paths: /v1/compose/formats: get: tags: - Compose summary: List Compose Formats description: > List the video **formats** `POST /v1/compose/video` can render — animated slideshow, cinematic b-roll, motion-graphics explainer, and more. Each format renders differently and internally uses different models; **callers pick a format (never a model) and see its cost.** The response also returns fixed **capabilities** (max script length, supported aspect ratios, clip window) so an agent can construct any valid compose call from a single discovery request. Formats with `available: false` are on the roadmap and cannot be dispatched yet. Formats may declare required `inputs` (e.g. a presenter image) that must be supplied. operationId: listComposeFormats parameters: - name: durationSec in: query required: false schema: type: integer default: 60 description: Target length (seconds) the cost estimate is scaled to. responses: '200': description: The format menu + capabilities. content: application/json: schema: type: object properties: data: type: object example: data: formats: - id: cinematic_broll label: Cinematic b-roll description: >- Generated image→video hero clips, continuity-chained, narration + captions. available: true costTier: high estimatedCredits: 296 trending: false tags: - brand - product - cinematic inputs: [] - id: animated_slideshow label: Animated slideshow description: >- Generated stills with Ken-Burns motion + fade transitions, narration over the top. available: true costTier: low estimatedCredits: 35 trending: false tags: - blog - explainer - fast inputs: [] capabilities: maxScriptDurationSec: 90 aspectRatios: - '16:9' - '9:16' - '1:1' - '4:5' - '4:3' defaultAspectRatio: '16:9' clipSeconds: min: 3 max: 10 default: 5 '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' components: responses: Unauthorized: description: Missing or invalid API key content: application/json: schema: type: object properties: error: type: string example: error: Invalid API key TooManyRequests: description: >- Rate limit exceeded. All `/v1/*` endpoints are currently limited to 100 requests per minute per IP. headers: RateLimit-Policy: description: Active rate limit policy. schema: type: string example: 100;w=60 RateLimit-Limit: description: Max requests allowed in the current window. schema: type: integer example: 100 RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer example: 0 RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer example: 60 Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 60 content: text/plain: schema: type: string example: Too many requests from this IP, please try again in a minute securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: 'Workspace API key. Prefix: `lma_`. Example: `lma_abc123...`' ````