canonical: https://jentic.com/apis/lumalabs.ai/lumalabs

# Lumalabs Dream Machine API

The Dream Machine API generates videos and images from text and image prompts, then refines the results. It lets you create a video or image generation, list and retrieve generations, upscale a finished result, reframe a video or image to a new aspect ratio, modify a video, and add audio, with a credits endpoint to check your balance. Requests are authenticated with a bearer token.

## For AI agents

Generate videos and images from prompts with Luma's Dream Machine, then upscale, reframe, modify, and add audio to the results.

## Scope

Does not handle text generation, image hosting, or video streaming. Use for generating and editing video and image media only.

## Capabilities

- Generate a video from a text or image prompt
- Generate an image from a prompt
- Upscale a completed generation to higher resolution
- Reframe a video or image to a new aspect ratio
- Add audio to a generation or modify an existing video
- Check the remaining credits before starting a job

## Use cases

### Generate video for an AI agent workflow

An AI agent integration created through Jentic turns a prompt into a finished clip. The Dream Machine API creates a video generation, exposes the generation to poll until it is ready, and can upscale or add audio afterwards, so the agent produces and refines video without the developer wiring the generation lifecycle by hand.

Example prompt: Create a video generation from a prompt, poll until it completes, then upscale the result

### Produce marketing images on demand

A campaign needs images generated to a brief. The Dream Machine API generates an image from a prompt and can reframe it to the aspect ratio a channel requires, so an automation produces on-brand visuals and adapts them for different placements from a single request flow.

Example prompt: Generate an image from a prompt and reframe it to a 9:16 aspect ratio

### Add sound to generated video

Silent generated clips often need an audio track. The Dream Machine API adds audio to a generation and can modify an existing video, so an agent can take a completed clip and produce a sound-enabled or edited version without re-generating from scratch.

Example prompt: Add audio to a completed video generation and retrieve the updated result

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/generations/video` | Create a video generation |
| POST | `/generations/image` | Generate an image |
| POST | `/generations/{id}/upscale` | Upscale a generation |
| POST | `/generations/{id}/audio` | Add audio to a generation |
| POST | `/generations/video/reframe` | Reframe a video |
| GET | `/generations/{id}` | Get a generation |
| GET | `/credits` | Get remaining credits |

## Key resources

- **Generations** — Create video and image generations, list them, retrieve one, and delete
- **Refinement** — Upscale, reframe, modify, and add audio to a generation
- **Concepts** — List the concepts available to guide a generation
- **Credits** — Check the remaining credit balance on the account

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 71 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 60 / 100
  - AI-Readiness & Agent Experience: 57 / 100
  - Agent Usability: 94 / 100
  - Security: 75 / 100
  - AI Discoverability: 67 / 100
- **View full report:** https://jentic.com/apis/lumalabs.ai/lumalabs/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Dream Machine API by hand means handling its bearer token and polling each generation until it finishes before you can upscale or add audio. Through Jentic you install once, import Dream Machine from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Dream Machine puts the generation id in the URL path for the detail, upscale, and audio operations, so a rule can limit your agent to creating and refining generations. You choose the operations it may call, so deleting a generation is not included unless you add it.
- **Credential handling:** Your Dream Machine token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'generate a video from a prompt' or 'upscale a generation', and Jentic returns the matching Dream Machine operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Runway** — Runway generates and edits AI video; Dream Machine generates video and images with upscale, reframe, and audio steps.
- **Stability AI** — Stability AI focuses on image generation models; Dream Machine covers both video and image generation.
- **Replicate** — Replicate hosts many open models behind one API; pair it with Dream Machine to combine other models with Luma's generation.

## FAQ

### What authentication does the Dream Machine API use?

The Dream Machine API authenticates with a bearer token in the Authorization header, per its OpenAPI spec. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's prompt or logs.

### Can I generate a video from a prompt with the Dream Machine API?

Yes. The video generation operation starts a job from a text or image prompt, and you retrieve the generation to poll until it is ready, after which you can upscale it or add audio.

### Can I check my remaining credits with the Dream Machine API?

Yes. The credits operation returns the remaining balance on the account, so an agent can confirm there is enough credit before starting a generation and avoid failed jobs.

### How do I generate a video through Jentic?

Install Jentic One on your own infrastructure with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then import the Dream Machine API from the API Directory and search for 'generate a video from a text prompt'. Store the token once and your agent can create and refine generations. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Dream Machine MCP server?

You don't need an MCP server to give your agent the Dream Machine API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent calls it, with operations discovered on demand instead of loaded into the agent's context.

### Can I limit what my agent is allowed to do with the Dream Machine API?

Yes. The generation id sits in the URL path for the detail, upscale, and audio operations, so a rule can scope the agent to creating and refining generations while deletion stays out of reach unless you add it. Every action it takes is recorded in an audit log.