storyshort_generate_video
Generate an AI short video from a topic, niche, art style, duration, and quality. Returns a video ID to poll for completion status.
Instructions
Generate an AI video from a topic. Returns a video ID for status polling. Costs 40 credits with the default voice; art style does not change the price. The request is refused with 402 INSUFFICIENT_CREDITS (credits needed, available, top-up URL) when the balance is short. Rendering is asynchronous: poll storyshort_get_video every 20-30 seconds until status is COMPLETED or FAILED. If get_video returns blockedReason, stop polling and act on it (e.g. top up credits).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"topic": "<topic>"
},
"name": "storyshort_generate_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| niche | No | Video niche (e.g., MOTIVATIONAL, AI_FACTS, SCARY_STORIES); see storyshort_list_niches | |
| topic | Yes | Video topic or script idea | |
| quality | No | Output resolution. Omit to use the plan's resolution. Asking for one the plan does not render returns 403 QUALITY_NOT_IN_PLAN. | |
| artStyle | No | Art style id (e.g., AUTOSHORTS, COMIC_BOOK, PIXEL_ART); legacy ids LEGO, DISNEY_TOON, STUDIO_GHIBLI are shown as Brick Toy, Storybook Cartoon, Hand-drawn Anime. See storyshort_list_niches | |
| duration | No | Target duration in seconds: 30, 60, or 90 |