> For the complete documentation index, see [llms.txt](https://docs.chatvideopro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatvideopro.com/conversation-starters/video-prompter-assistant.md). # Video Prompter Assistant ### How to Use the Video Prompter Assistant {% embed url="" %} ### What It Does The Video Prompter Assistant: * **Guides you through prompt creation** with structured questions * **Recommends technique cards** with proven prompt templates * **Optimizes prompts** for specific video models * **Ensures completeness** (camera movement, style, setting, etc.) * **Outputs JSON-ready prompts** for advanced workflows * **Uses exact template phrases** from selected cards for best results
### How to Use #### Step 1: Discovery The assistant starts by asking: **"What kind of video would you like to create today?"** You'll see a table with video-type options:
**Simply describe your video idea** - for example: * "I want a cinematic shot of a coffee shop." * "A product ad for a new smartphone" * "An animated logo reveal" Attach an image to improve the accuracy of the scene description. #### Step 2: Refinement & Recommended Cards This is where the magic happens. After you describe your video idea, the assistant: 1. **Searches its knowledge base** for relevant video generation techniques 2. **Shows 2-4 recommended technique cards** based on your description 3. **Asks targeted refinement questions** in a table format
**Understanding Technique Cards** **What are technique cards?** * **Selectable prompt templates** with proven phrasing that AI video models understand * **Pre-written templates** with placeholders like `[Subject]`, `[Action]`, `[Setting]` * **From knowledge base** - Curated techniques from professional video generation workflows * **Custom cards** - Sometimes created specifically for your unique request **Card types:** * **Camera cards** - Camera movements and techniques (push-in, dolly, orbit, etc.) * **Effect cards** - Visual effects and techniques (slow motion, time-lapse, etc.) * **Template cards** - Complete shot templates with all elements **Example card:** ``` Card Name: "Slow Push-In" Description: "Cinematic approach shot." Template: "Slow push-in on [Subject] performing [Action] in [Setting], capturing [Key Moment] with [Visual Detail]." ``` **How to Use Cards** 1. **Review the recommended cards** - They appear as selectable boxes in the chat 2. **Click cards to select them** - Selected cards highlight (you can select multiple) 3. **Cards contain templates** - Each card has a template with placeholders 4. **Answer refinement questions** - The assistant asks 2-3 targeted questions in a table 5. **Provide details** - Your answers fill in the template placeholders **Example refinement table:** | **Question** | **What I Need** | | -------------------- | --------------------------------------------- | | **Subject Details:** | What unique traits should the character have? | | **Setting:** | Where does this take place? | | **Camera Movement:** | How should the camera move? | **Card Selection Strategy** **Select cards when:** * ✅ They match your vision closely * ✅ You want proven techniques that work well * ✅ The template phrasing sounds right for your video * ✅ You want to combine multiple techniques **Skip cards when:** * ❌ None match your specific needs * ❌ You have a very unique vision * ❌ You prefer to describe everything yourself **Note:** You can proceed without selecting cards - the assistant will create a custom prompt based on your description. #### Step 3: Synthesis **When synthesis happens:** * After you've selected technique cards (if any) AND * You indicate readiness (e.g., "continue", "ready", "let's do it", "create the prompt") **What happens:** 1. **Template integration** - If you selected cards, their template text is used EXACTLY (verbatim) 2. **Placeholder filling** - Your refinement answers fill in the `[Subject]`, `[Action]`, etc. 3. **JSON generation** - Everything is combined into a polished JSON prompt under 1000 characters 4. **Model optimization** - The prompt is optimized for the recommended video model **Output format:** You'll receive a complete JSON prompt ready to use: ```json { "description": "[Detailed description incorporating selected techniques, visual style, action, environment]", "camera": { "motion": "[Camera motion - uses exact template phrases from selected cards]", "angle": "[Camera angle]", "composition": "[Composition]" }, "audio": { "dialogue": "[Dialogue or null]", "sfx": "[Sound effects]", "music": "[Music style]" }, "negative_prompt": "[Things to avoid - blur, distortion, etc.]", "character_details": "[Character description if .applicable, otherwise null]" } ``` #### Step 4: Use the Prompt 1. **Copy the JSON prompt** from the code block 2. **Open Generate Media** in Chat Video Pro 3. **Select the recommended model** (Sora, Veo, Kling, etc.) 4. **Paste the full JSON** into the prompt field — Chat Video Pro **automatically extracts the `description` field** for generation, so you don't need to manually pull out just the description text 5. **Generate your video** **Optional:** If you want to refine the prompt before generating, copy just the `"description"` string and edit it directly. #### How Templates Work **Template example:** ``` "Slow push-in on [Subject] performing [Action] in [Setting], capturing [Key Moment] with [Visual Detail]." ``` **After filling placeholders:** ``` "Slow push-in on a barista preparing espresso in a cozy coffee shop, capturing the steam rising from the cup with a shallow depth of field." ``` **Why this works:** * "Slow push-in" is a specific camera language that AI models recognize * The structure ensures all elements are included * The phrasing is optimized for video generation APIs ### Complete Workflow Example #### Example 1: With Card Selection 1. **User:** "I want a cinematic coffee shop video." 2. **Assistant shows cards:** * "Slow Push-In" (selected) * "Golden Hour Lighting" (selected) * "Shallow Depth of Field" (not selected) 3. **Assistant asks:** * What's the main subject? → "A barista making espresso." * What's the setting? → "Cozy urban coffee shop.p" * What time of day? → "Early morning, golden hour.r" 4. **Synthesis creates JSON** using the exact template phrases from selected cards 5. **User generates a video** with an optimized prompt #### Example 2: Without Card Selection 1. **User:** "I want a unique video of a robot dancing in space." 2. **Assistant shows cards:** * "Orbit Camera" (related, not selected) * "Slow Motion" (related, not selected) 3. **User:** "Just create it based on my description." 4. **Assistant creates a custom prompt** without using card templates 5. **User generates a video** with a custom-tailored prompt ### Prompt Structure A well-structured video prompt includes: #### Essential Elements 1. **Subject** - Clear description of main focus 2. **Setting** - Location, time, environment 3. **Action** - What's happening, movement 4. **Camera** - Movement, angle, framing (often from cards) 5. **Style** - Visual aesthetic, mood 6. **Details** - Lighting, colors, atmosphere ### Model-Specific Optimization The assistant tailors prompts for different models: #### Sora 2 * Emphasizes cinematic language * Works well with detailed scene descriptions * Supports longer prompts (up to 12 seconds) * Cards often include "cinematic" and "film grain" templates #### Veo 3.1 * Focuses on dialogue and audio cues * Optimizes for character consistency * Great for narrative scenes * Cards emphasize character and dialogue templates #### Kling 3.0 / O3 * Emphasizes camera movement and cinematic motion * Works well with dynamic action and human subjects * Supports complex camera moves (360°, FPV, orbit, dolly) * Kling 3.0 Pro/Standard for universal use (T2V, I2V, transition) * Kling O3 for advanced motion understanding and character reference * Cards include advanced camera technique templates #### Hailuo 2.3 * Optimizes for action and motion * Great for sports and dynamic scenes * Emphasizes fluid movement * Cards focus on motion and action templates ### Advanced: JSON Prompt Format For advanced users, the assistant outputs JSON-ready prompts: ```json { "description": "Slow push-in on a barista preparing espresso...", "model": "sora-2", "aspect_ratio": "16:9", "duration": 8, "style": "cinematic", "camera_movement": "push-in", "lighting": "golden hour" } ``` **Key fields:** * `description` - Full prompt text (incorporates card templates) * `camera.motion` - Exact camera movement from selected cards * `audio` - Dialogue, SFX, or music cues * `negative_prompt` - Things to avoid * `character_details` - Character descriptions, if applicable ### Tips for Best Results 1. **Select relevant cards** - Choose cards that match your vision 2. **Be specific in answers** - "Cozy coffee shop" is better than "coffee shop." 3. **Combine multiple cards** - Select 2-3 cards for richer prompts 4. **Trust the templates** - Card templates use proven phrasing 5. **Answer all questions** - More details = better prompts 6. **Review the JSON** - Check that selected card templates are included 7. **Iterate if needed** - Ask for adjustments or try different cards ### Common Use Cases * **Product showcases** - Detailed product videos with cinematic cards * **B-roll creation** - Background footage using camera movement cards * **Scene establishment** - Setting the mood with lighting/style cards * **Character introductions** - Character-focused shots with portrait cards * **Transition elements** - Between-scene footage using transition cards ### Troubleshooting #### "No cards are showing." **Solutions:** * The assistant may not have found relevant techniques * Try being more specific about your video type * The assistant will create a custom prompt without cards * You can still get excellent results without cards #### "Cards don't match what I want." **Solutions:** * Don't select cards that don't fit * Answer refinement questions with your specific vision * The assistant will create a custom prompt * You can ask for different card suggestions #### "Prompt is too vague." **Solutions:** * Select technique cards for structure * Answer all refinement questions thoroughly * Add more specific details in your description * Ask the assistant to expand on specific elements #### "Selected cards aren't in the final prompt." **Solutions:** * Check that you actually selected the cards (they should highlight) * Make sure you said "continue" or "ready" after selecting * The templates should appear verbatim in the JSON * If missing, ask the assistant to include the selected techniques #### "Model recommendation doesn't match my needs." **Solutions:** * Specify your requirements clearly in Step 1 * Mention if you need audio (Veo is best) * State duration preferences * Describe camera movement needs (Kling for complex moves) *** **Next:** Learn about the[ Brand Voice Assistant](/conversation-starters/brand-voice-assistant.md) for consistent brand content. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.chatvideopro.com/conversation-starters/video-prompter-assistant.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.