Make a faceless story video
start_story_videoMake an AI Story Video (a faceless narrated short in the chosen format: what if, scary story, history, body facts, choose your path, cartoon story...). It spends credits from the user's MakeViral account (a part that fails gives its credits back) and takes several minutes: this call returns at once, then call get_story_video with wait true. Two ways: 1) your own script as draft (written with story_video_guide's prompts; MakeViral then only makes the video and charges no writer), or 2) only the idea (and the user's own story, if any), and MakeViral writes the script. Before calling: check it with check_story_video and tell the user the price in credits. Calling again with the same input within 10 minutes returns the first story.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_story_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| idea | No | One line, e.g. 'What if the moon disappeared?' | |
| pace | No | ||
| draft | No | Your own script: the JSON the writer prompt of story_video_guide asks for (title, characters, places, scenes, choices, stats...). | |
| music | No | ||
| story | No | The user's own full story, when there is one: the script keeps its events, names and facts | |
| style | No | Art style. Default: the format's. | |
| aspect | No | Default 9:16 (TikTok, Reels, Shorts). | |
| format | No | The video format. Default what-if. story_video_guide lists them with examples. | |
| quality | No | How many scenes move (AI clips) instead of stills. Default: the format's. | |
| seconds | No | Length in seconds. Default: the format's. | |
| voiceId | No | Narrator voice id (story_video_guide). Default: the format's. | |
| captions | No | Caption style. Default: the format's. | |
| language | No | Narration language. Default en. | |
| requestId | No | Optional id (8-64 letters, digits, - or _). The same id never charges twice. | |
| continueFrom | No | Part 2 of a finished choose-your-path (or 'Part 2?') story of this user |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| story | Yes |