# AI Story Short Video Generator (`bhansalisoft/ai-story-short-video-generator`) Actor

AI Story short Video Generator - This tool Create AI story short video by generating scene and ai images, audio then final short video for youtube and instagram and other social media

- **URL**: https://apify.com/bhansalisoft/ai-story-short-video-generator.md
- **Developed by:** [bhansalisoft](https://apify.com/bhansalisoft) (community)
- **Categories:** Automation, AI, Social media
- **Features:** Full permissions
- **Stats:** 156 total users, 4 monthly users, 99.9% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 generate ai scenes

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🎬 AI Story to Short Video Generatore

This tool based on IDEA tool automatically create story and converts your **story** into a **complete short video** using AI.

It automatically:

- based on IDEA tool automatically create story
- Splits your story into scenes
- Generates an image for each scene
- Creates AI voice narration for each scene
- Combines everything into a final video
- Gives you download links for all assets

***

### ✨ What You Will Get

After the run finishes, you will receive:

✅ Scene-wise text
✅ AI-generated images
✅ AI-generated voice audio
✅ Final combined video
✅ Public download links

All of these will be saved in the **Apify Dataset**.

***

### 📝 How to Use

#### Step 1: Enter Your Story

In the input box, paste your story:

```json
{
  "story": "Once upon a time..."
}
```

You can paste:

- Short stories
- Moral stories
- Kids stories
- YouTube scripts
- Narratives

***

#### Step 2: Run the Actor

Click **Start**.

The system will now:

1. Analyze your story
2. Break it into scenes
3. Generate AI images
4. Generate AI narration
5. Create a video
6. Upload everything to cloud storage

***

#### Step 3: Get Your Results

Once completed, go to the **Dataset** tab.

You will see something like:

```json
[
  {
    "Result_Type": "scene1",
    "Result": "In a sunny meadow, a kind mother pig tells her three lively piglets, Percy, Pippa, and Peter, that it is time for them to build their own houses and set out into the world. The piglets hug their mother goodbye and set off down the road together."
  },
  {
    "Result_Type": "scene2",
    "Result": "Percy, who loves to play, meets a man with a cart full of straw. Percy politely asks for straw and quickly builds himself a cozy little house. He is delighted with how fast he finishes and dances around his new home."
  },
  {
    "Result_Type": "scene3",
    "Result": "Pippa meets a man with a cart of sticks and politely asks for some to build her house. She constructs a sturdy-looking wooden house and feels proud as she admires her handiwork."
  },
  {
    "Result_Type": "scene4",
    "Result": "Peter continues alone and meets a man with strong bricks. He asks for bricks and meticulously builds himself a solid brick house, taking his time to make sure it is strong and safe."
  },
  {
    "Result_Type": "scene5",
    "Result": "A big, hungry wolf arrives at Percy's house of straw. He demands to be let in, threatens to blow the house down, and does so easily. Percy flees in fear towards Pippa's stick house."
  },
  {
    "Result_Type": "scene6",
    "Result": "The wolf follows Percy to Pippa's house and huffs and puffs until he blows down the stick house as well. Both Percy and Pippa run to Peter's brick house for safety."
  },
  {
    "Result_Type": "scene7",
    "Result": "The wolf arrives at Peter's brick house and tries to blow it down, but it stands firm. Frustrated, the wolf tries to sneak in through the chimney, but falls into a pot of boiling water inside. Burned and defeated, the wolf runs away forever."
  },
  {
    "Result_Type": "scene8",
    "Result": "The three little pigs live together in Peter's sturdy brick house. They are safe and happy, having learned the value of hard work, planning, and perseverance."
  },
  {
    "Result_Type": "scene_1.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_1.png?signature=1GDOR8DPJsIvZDRIYYtbU"
  },
  {
    "Result_Type": "scene_2.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_2.png?signature=1oyMuYoRPaMpmX4ygcBDA"
  },
  {
    "Result_Type": "scene_3.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_3.png?signature=eu1wbfnSsi6B9TJNXDsN"
  },
  {
    "Result_Type": "scene_4.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_4.png?signature=1QcWkI7fx7TBwBGa27cs3"
  },
  {
    "Result_Type": "scene_5.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_5.png?signature=BBDedBdYZeLvPcaQhKnp"
  },
  {
    "Result_Type": "scene_6.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_6.png?signature=cXXFLJ69y8ZPe2Q2yLJX"
  },
  {
    "Result_Type": "scene_7.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_7.png?signature=p6HmcHvYsl7fbxYGQl3o"
  },
  {
    "Result_Type": "scene_8.png",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_8.png?signature=17vmQH0LIpVUTwJEGfAjX"
  },
  {
    "Result_Type": "scene_1.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_1.mp3?signature=9kh5EvxYzYbpIPPZRQLK"
  },
  {
    "Result_Type": "scene_2.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_2.mp3?signature=gyHJIFMKclnWnaycW5z6"
  },
  {
    "Result_Type": "scene_3.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_3.mp3?signature=1fdw4uqVYF3NZzLPZmtB"
  },
  {
    "Result_Type": "scene_4.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_4.mp3?signature=1HNneDwwEWfoDBmGGzwTZ"
  },
  {
    "Result_Type": "scene_5.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_5.mp3?signature=lGWCgSbQFBRizqrm6iih"
  },
  {
    "Result_Type": "scene_6.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_6.mp3?signature=1jkgbIHIX8jXYQa7vB6K"
  },
  {
    "Result_Type": "scene_7.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_7.mp3?signature=1EJRHVnNMxi7oLPXWR3yj"
  },
  {
    "Result_Type": "scene_8.mp3",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/scene_8.mp3?signature=1IsKnS9tNLLfPVZJFkC4y"
  },
  {
    "Result_Type": "Final Short Video",
    "Result": "https://api.apify.com/v2/key-value-stores/w3d1POBcDbb0qWHhl/records/final_video.mp4?signature=79TXsC94avgxgzVcQcow"
  }
]
```

***

### 📥 Downloading Files

Just click the URLs:

- 🖼️ Images → Download each scene image
- 🔊 Audio → Download each scene narration
- 🎥 Final Video → Download full video

***

### Demo video

https://youtu.be/TIOkPjTOcok

### 📌 Best Practices

✔ Keep stories under 2,000–3,000 words
✔ Use clear language
✔ Avoid extremely long paragraphs
✔ Fewer scenes = faster processing
✔ More scenes = higher cost

***

### 💰 Cost Information

This tool uses OpenAI services:

| Feature          | Cost Type       |
| ---------------- | --------------- |
| Text generation  | Token-based     |
| Image generation | Per image       |
| Voice generation | Per minute      |
| Video creation   | Processing time |

Longer stories = more scenes = higher cost.

***

### ⏳ Processing Time

| Story Size          | Estimated Time |
| ------------------- | -------------- |
| Short (1–2 scenes)  | 1–2 minutes    |
| Medium (5–6 scenes) | 3–5 minutes    |
| Long (8+ scenes)    | 6–10 minutes   |

# Actor input Schema

## `Story` (type: `string`):

Enter your Story idea, based on our tool will generate story and there scene and then create ai images and ai scene and audio and final short video will generate

## `maxScene` (type: `integer`):

Maximum number of Scene in video

## `Write_onImage` (type: `boolean`):

Enable Write Scene on Image

## `Video_Type` (type: `string`):

Video_Type

## `Image_StyleValue` (type: `string`):

AI Video Type

## Actor input object example

```json
{
  "Story": "The Last City on Earth Everyone lives inside one giant city—until a girl discovers the outside world.",
  "maxScene": 4,
  "Write_onImage": false,
  "Video_Type": "short",
  "Image_StyleValue": "Cartoon"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "Story": "The Last City on Earth Everyone lives inside one giant city—until a girl discovers the outside world.",
    "Video_Type": "short",
    "Image_StyleValue": "Cartoon"
};

// Run the Actor and wait for it to finish
const run = await client.actor("bhansalisoft/ai-story-short-video-generator").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "Story": "The Last City on Earth Everyone lives inside one giant city—until a girl discovers the outside world.",
    "Video_Type": "short",
    "Image_StyleValue": "Cartoon",
}

# Run the Actor and wait for it to finish
run = client.actor("bhansalisoft/ai-story-short-video-generator").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "Story": "The Last City on Earth Everyone lives inside one giant city—until a girl discovers the outside world.",
  "Video_Type": "short",
  "Image_StyleValue": "Cartoon"
}' |
apify call bhansalisoft/ai-story-short-video-generator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bhansalisoft/ai-story-short-video-generator"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/kBNfFX3mBdxkvbGxg/builds/e4eXuYD6Ka6qimVWm/openapi.json
