Generate script title
Generate a short-form video title and hookAngle for a topic enum. Costs credits. If the user only says "write a title" without a topic, map their subject to the closest topic enum, or if unclear offer a short list of matching topics and wait. Do not invent topic values outside the enum. Prefer calling this before generate_script so you can pass title + hookAngle through. Requires scripts:generate scope.
Generate script title
Tool name: generate_title
Required scope: scripts:generate
Generate a short-form video title and hookAngle for a topic enum. Costs credits. If the user only says "write a title" without a topic, map their subject to the closest topic enum, or if unclear offer a short list of matching topics and wait. Do not invent topic values outside the enum. Prefer calling this before generate_script so you can pass title + hookAngle through. 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 | Required topic enum. Map the user request to the closest value (for example food → FOOD_FACTS, history → HISTORICAL, AI → TECH_AI). If the topic is ambiguous, briefly offer 3–5 matching options and wait for the user before calling this tool. |
Get Creative Studio model
Return the full parameter schema for one public modelId (required/optional settings, media inputs, enums, defaults, credit hints). Includes creditsFrom (minimum), creditsAtDefaults (schema defaults), and estimatedCredits when you pass parameters (duration, generate_audio, mode, resolution, etc.). Call after list_creative_models when you need exact parameter names or a quote before create_creative_generation, or to confirm a media parameter's maxItems when combining multiple reference images into one output. Requires read scope.
Generate script
Generate a faceless short-form voiceover script from topic + title. Costs credits per variation. Prefer using a title and hookAngle from generate_title when available. Use the same topic enum mapping rules as generate_title. Ask before enabling useRagebait unless the user asked for provocative/viral tone. Requires scripts:generate scope.