narrator-ai-video-generation

The saved excerpt is a snapshot from review. The external source remains the complete and most current version.

---
name: narrator-ai-video-generation
description: Generate AI-narrated video content using narrator-ai-cli for movie commentary, short dramas, and film analysis
triggers:
  - "create a movie narration video"
  - "generate film commentary with narrator-ai"
  - "make a video narration for this movie"
  - "produce AI-narrated content"
  - "create short drama narration"
  - "generate video commentary using narrator-ai-cli"
  - "help me make a narrated movie clip"
  - "create narration video with custom voice"
---

# Narrator AI Video Generation Skill

> Skill by [ara.so](https://ara.so) — Devtools Skills collection.

This skill enables AI agents to create professional movie narration videos using the `narrator-ai-cli` tool. The CLI provides access to ~100 movies, 146 BGM tracks, 63 dubbing voices, and 90+ narration templates for automated video production.

## What This Tool Does

`narrator-ai-cli` is a command-line interface for the Narrator AI service that automates the creation of movie narration videos. It handles:

- **Adapted Narration**: Select existing movie content and generate narration scripts
- **Original Narration**: Create narration from custom scripts and material
- **Voice Synthesis**: Text-to-speech with 63+ voice options
- **Voice Cloning**: Clone custom voices for narration
- **Video Composition**: Automatic video assembly with BGM, dubbing, and visual templates

## Installation

### Prerequisites

- Python 3.10 or higher
- pip package manager
- An API key from Narrator AI (contact [email protected])

### Install CLI

```bash
# Install from GitHub
pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"

# Verify installation
narrator-ai-cli --version
```

### Configure API Key

```bash
# Set your API key (required for all operations)
narrator-ai-cli config set app_key $NARRATOR_APP_KEY

# Verify configuration
narrator-ai-cli config show
```

Environment variable setup:
```bash
export NARRATOR_APP_KEY="your-api-key-here"
```

## Core Commands

### Configuration

```bash
# Show current configuration
narrator-ai-cli config show

# Set API key
narrator-ai-cli config set app_key <key>

# Set base URL (optional)
narrator-ai-cli config set base_url <url>
```

### Resource Discovery

```bash
# List available movies
narrator-ai-cli movie list

# Search for specific movie
narrator-ai-cli movie list --keyword "Shawshank"

# List narration templates
narrator-ai-cli template list

# List available background music
narrator-ai-cli bgm list --keyword "epic"

# List dubbing voices
narrator-ai-cli dubbing list --gender male --language zh-CN
```

### Adapted Narration Workflow (Standard Path)

Use when working with existing movie content:

```bash
# Step 1: Upload reference file (optional, for custom content)
narrator-ai-cli file upload /path/to/reference.mp4

# Step 2: Create movie selection task
narrator-ai-cli movie-select create \
  --movie-id <movie_id> \
  --template-code <template_code> \
  --reference-file-id <file_id>  # optional

# Step 3: Poll for clip data result
narrator-ai-cli movie-select get <task_id>

# Step 4: Create narration script
narrator-ai-cli narration-script create \
  --clip-data-file-id <clip_data_file_id> \
  --template-code <template_code> \
  --requirement "Make it funny and engaging"

# Step 5: Poll for script result
narrator-ai-cli narration-script get <task_id>

# Step 6: Compose final video
narrator-ai-cli magic-video create \
  --clip-data-file-id <clip_data_file_id> \
  --narration-script-file-id <script_file_id> \
  --bgm-code <bgm_code> \
  --dubbing-code <dubbing_code>

# Step 7: Poll for video result
narrator-ai-cli magic-video get <task_order_num>
```

### Original Narration Workflow (Fast Path)

Use when creating from scratch with custom script:

```bash
# Step 1: Upload your video material
narrator-ai-cli file upload /path/to/video.mp4

# Step 2: Create narration script (without clip data)
narrator-ai-cli narration-script create \
  --template