---
title: "Enhance Video Prompt"
method: POST
path: "/api/prompt-enhancement/video"
tags: ["Prompt Enhancement"]
---

# Enhance Video Prompt

`POST /api/prompt-enhancement/video`

Enhance a text description into a detailed video generation prompt.

Uses advanced prompting techniques for natural-speed, physics-accurate motion:
- Explicit camera movement terminology
- Speed modifiers (fighting slow-motion default)
- Cohesive action descriptions
- Atmospheric details

If project_id is provided, uses the project's configured style (if available).
Requires authentication when project_id is provided.

## Request body

- VideoPromptRequest — Request model for video prompt enhancement
  - `text` string, required — The base text to enhance into a video prompt
  - `project_id` string, nullable — Optional project ID to use project's configured style
  - `duration` integer, nullable — Video duration in seconds (4-12)
  - `camera_movement` string, nullable — Desired camera movement (e.g., 'static', 'dolly in', 'tracking')
  - `style` string, nullable — Optional style guidance (overridden by project style if project_id provided)
  - `image_urls` string[], nullable — Optional image URLs providing visual context (e.g., start/end keyframes)
  - `video_context` string, nullable — Optional video context or selected model capability summary

## Response `200`

Successful Response

- PromptResponse — Response model for prompt enhancement
  - `enhanced_prompt` string, required — The enhanced prompt
  - `original_text` string, required — The original input text

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/latted/apis/motion-graphics-designer-api.md) · [All operations](https://skmtc.dev/latted/apis/motion-graphics-designer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/latted/motion-graphics-designer-api/revisions/36d149b525df/schema)