Skip to main content
POST
/
v1
/
content
/
create
Create Content
curl --request POST \
  --url https://app.uselamina.ai/v1/content/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "brief": "Create an eye-catching Instagram post showcasing our new summer sneaker collection with lifestyle photography",
  "platform": "instagram",
  "modality": "image",
  "brandProfileId": null,
  "campaignId": null
}
'
{
  "data": {
    "runId": "fc32ae7d-6840-4be3-8fb1-539a60e33fc3",
    "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
    "workflowName": "AI Product Photography",
    "status": "queued"
  }
}

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.

One-call creation. Describe what you want, and the API handles app selection, input mapping, brand context injection, and execution. Instead of manually choosing an app and mapping inputs, pass a brief describing the content you need. The engine resolves brand context, selects the best-fit app, injects creative guidance, and starts the execution. The operation is asynchronous — use the returned run ID with the wait, stream, or get-run endpoints to retrieve results. Best for agent-driven workflows where you want a single call to go from intent to finished asset.

Authorizations

​
x-api-key
string
header
required

Workspace API key. Prefix: lma_. Example: lma_abc123...

Body

application/json
​
brief
string
required

Natural-language description of what content to create. This is the primary input.

​
platform
string | null

Target platform (e.g. instagram, tiktok, facebook). Helps select the right app and optimize guidance.

​
modality
string | null

Desired content modality (e.g. image, video). Helps select the right app.

​
brandProfileId
string<uuid> | null

Scope brand context to a specific brand profile.

​
campaignId
string<uuid> | null

Scope guidance to a specific campaign.

​
appId
string<uuid> | null

Force a specific app instead of automatic selection. Use GET /v1/apps to find app IDs.

​
inputs
object

Override specific input parameters on the selected app. Keys are parameter names.

​
templateId
string | null

Apply a content template for structured guidance. Use GET /v1/templates to find template IDs.

​
autoQuality
object

Auto-quality guarantee. Score output after completion and retry if below threshold.

​
aspectRatio
string | null

Output aspect ratio. Auto-mapped to the matching workflow parameter. Common values: 1:1, 16:9, 9:16, 4:3, 3:4, 4:5, auto.

Example:

"9:16"

​
metadata
object

Freeform context about the target placement, injected into prompt engineering as structured document context. Useful for passing context from the calling application without manually writing it into the brief.

Example:
{
  "documentTitle": "Summer Collection 2026",
  "fieldName": "heroImage",
  "fieldPurpose": "Main banner image for collection landing page",
  "dimensions": { "width": 1920, "height": 1080 }
}

Response

Content creation started. Poll the run for results.

​
data
object

Run details including runId, workflowId, and status.