> For the complete documentation index, see [llms.txt](https://docs.qolaba.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qolaba.ai/video-generation/input-controls/prompt-and-magic-prompt.md).

# Prompt and Magic Prompt

How to write effective video prompts in Qolaba and how to use Magic Prompt to automatically enhance them for better generation results.

The prompt is the primary input for every video generation. It tells the model what to generate — the subject, environment, action, camera movement, and mood. How you write it directly determines the quality and accuracy of the output.

***

#### Writing an Effective Prompt

A strong video prompt covers four elements:

| Element             | What to Include                                             |
| ------------------- | ----------------------------------------------------------- |
| **Subject**         | What or who is in the scene                                 |
| **Environment**     | Where the scene takes place — setting, time of day, weather |
| **Action & Motion** | What is happening — movement of subject and camera          |
| **Style & Mood**    | Visual tone, aesthetic, and feeling                         |

**Weak prompt:**

```
A person walking in a city.
```

**Strong prompt:**

```
A young woman in a long coat walking slowly through a rain-soaked
city street at night, neon signs reflecting on wet pavement,
slow tracking shot following from behind, cinematic and moody.
```

The second prompt gives the model a subject, environment, motion direction, camera movement, and visual mood — producing a far more consistent and usable output.

***

#### Prompt Structure Guide

**1. Lead with your subject** Start with who or what is the focus of the scene.

```
A lone astronaut standing on the surface of Mars...
```

**2. Describe the environment** Add setting, time, weather, and atmosphere.

```
...surrounded by vast red desert plains under a pale orange sky at dusk...
```

**3. Define the motion** Specify both subject movement and camera movement.

```
...slowly turning to look at the horizon, camera pulling back in a wide arc...
```

**4. Set the style and mood** Add visual tone, aesthetic references, and quality descriptors.

```
...cinematic, photorealistic, sharp focus, golden hour lighting.
```

**Full combined prompt:**

```
A lone astronaut standing on the surface of Mars, surrounded by vast
red desert plains under a pale orange sky at dusk, slowly turning to
look at the horizon, camera pulling back in a wide arc, cinematic,
photorealistic, sharp focus, golden hour lighting.
```

***

#### What to Avoid

* **Vague descriptors** — "dramatic and cinematic" is less effective than "slow dolly forward through a foggy forest at dawn"
* **Overloading with multiple scenes** — Keep each prompt focused on a single scene or moment
* **Conflicting instructions** — Avoid combining contradictory motion directions (e.g., zoom in and pull back simultaneously)
* **Describing abstract concepts without visual grounding** — "a feeling of loneliness" needs a concrete visual anchor to be generatable

***

#### Magic Prompt

Magic Prompt is an AI-powered enhancement tool that takes your prompt and rewrites it into a more detailed, generation-optimized version — automatically adding descriptive language, cinematic direction, and stylistic detail that improves output quality.

**When to Use It**

Use Magic Prompt when:

* Your prompt is short or underdeveloped
* You are not sure how to describe camera movement or visual style
* You want to quickly explore an enhanced version of a simple idea
* You are new to video prompting and want a better starting point

**When to Skip It**

Skip Magic Prompt when:

* Your prompt is already highly specific and detailed
* You are working with reference images where strict visual consistency matters
* You need precise control over exactly what the model generates

**How to Use It**

1. Enter your base prompt in the prompt input field
2. Click the **Magic Prompt** button
3. Qolaba rewrites and enhances your prompt automatically
4. Review the enhanced version — edit if needed before generating

**Before Magic Prompt:**

```
A dog running on a beach.
```

**After Magic Prompt:**

```
A golden retriever running joyfully along a sun-drenched sandy beach,
waves crashing gently in the background, slow-motion tracking shot
from the side, warm afternoon light, shallow depth of field,
cinematic and vibrant.
```

{% hint style="info" %}
Use Magic Prompt as a starting point, not a final step. Always review the enhanced prompt and adjust anything that doesn't match your intent before generating.
{% endhint %}
