---
title: "Narration Script Endpoint"
method: POST
path: "/api/v1/ai-video-storyboard/narration-script"
tags: ["aiVideoAdStoryBoard"]
---

# Narration Script Endpoint

`POST /api/v1/ai-video-storyboard/narration-script`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/ai-video-storyboard/narration-script`
- Auth: HTTP bearer

Generate a final Veo 3.1-compliant ai_video_prompt based on prompt_type.

**Request Fields:**
- `ai_video_prompt`: The original video prompt description
- `voiceover`: The voiceover text that will be spoken (used for narration/lipsync types)
- `prompt_type`: One of "narration", "lipsync", or "description" (or empty/None)

**Response:**
Returns a dictionary with:
- `ai_video_prompt`: Final, Veo 3.1-compliant prompt ready for Veo model
- `voiceover`: The voiceover text (extracted from prompt for description type, or provided for other types)

**Prompt Types:**
- **"narration"**: Combines ai_video_prompt and voiceover, NO lip sync, NO background sound effects
- **"lipsync"**: Combines ai_video_prompt and voiceover, PROPER lip sync required, NO background sound effects
- **"description"**: Cleans and enhances ai_video_prompt, extracts speaking text as voiceover

## Request body

- NarrationScriptRequestDTO: Request to generate a narration script for a project scene.
  - `ai_video_prompt` string, required
  - `voiceover` string, required
  - `prompt_type` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/f84fc05f417b?raw)