Generate script
Generate a faceless short-form voiceover script from a topic and title. Uses credits. Requires scripts:generate scope.
Generate script
Tool name: generate_script
Required scope: scripts:generate
Generate a faceless short-form voiceover script from a topic and title. Uses credits. Requires scripts:generate scope.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
topic | enum (INTERESTING_FACTS, REDDIT_STORIES, CREEPY_STORIES, QUICK_HACKS, PHILOSOPHICAL, STORYTELLING, OPINION_PIECES, MOTIVATIONAL, VIRAL_FACTS, HISTORICAL, BOOKS_MOVIES, TRUE_CRIME, SCIENCE_EXPLAINED, PSYCHOLOGY, MONEY_FINANCE, RELATIONSHIPS, WORKPLACE, SURVIVAL, ANCIENT_CIVILIZATIONS, ANIMALS_NATURE, TECH_AI, FOOD_FACTS, SPORTS, POP_CULTURE, WHAT_IF, URBAN_LEGENDS) | required | Script topic category. |
title | string | required | Video title or concept. |
hookAngle | string | optional | Optional hook angle from title generation. |
duration | string | optional | Target duration hint. |
useHook | boolean | optional | |
useCTA | boolean | optional | |
useRagebait | boolean | optional | |
variations | enum (1, 2) | optional |
Generate script title
Generate a short-form video title and hook angle for a topic. Uses credits. Requires scripts:generate scope.
Create Creative Studio generation
Start an async Creative Studio image or video generation. Returns a generation id and statusUrl — poll get_creative_generation until status is completed or failed. mediaUrls accepts any public HTTPS URL, including outputUrl from a prior generation for chained workflows. For local files, call request_creative_media_upload first, upload bytes with curl, then pass mediaUploads. Requires creative:generate scope.