Skip to main content

​
Overview

Submits a text prompt to create video content for a specific chapter. This tool waits for completion (unlike the REST API which returns immediately), making it perfect for conversational workflows.
This tool polls for up to 30 seconds waiting for the video content to be created. If it takes longer, it will return a timeout message.

​
Parameters

​
project_id
string
required
The project ID (e.g., prj_abc123xyz)
​
chapter_title
string
required
The chapter name (will create the chapter if it doesn’t exist)
​
prompt
string
required
Text description of the video content to create (1-5000 characters)
​
force
boolean
Force processing even if another prompt is already being processed (default: false)

​
Returns

Returns the completion status after waiting for processing to finish.

​
Example Usage

​
In Claude

Create an intro video for chapter "Introduction" with our company logo and tagline

For the "Product Demo" chapter, create a video showing:
- Product features in action
- Customer testimonials overlay
- Call to action at the end
Use modern, professional aesthetics with blue branding

​
Direct Tool Call

{
  "name": "AddVideoPrompt",
  "arguments": {
    "project_id": "prj_abc123xyz",
    "chapter_title": "Introduction",
    "prompt": "Create an engaging intro with company logo, fade-in animation, and tagline 'Innovation Simplified'. Use blue and white colors, modern aesthetic, 15 seconds duration.",
    "force": false
  }
}

​
Response (Success)

{
  "status": "completed",
  "message": "Video content created successfully",
  "chapter_id": "cht_def456uvw",
  "processing_time_seconds": 45
}

​
Response (Timeout)

{
  "status": "timeout",
  "message": "Processing is still in progress after 30 seconds. Please check the chapter status manually.",
  "chapter_id": "cht_def456uvw"
}

​
Writing Effective Prompts

Create a product showcase with:
- White background
- Product rotating 360 degrees
- Highlight key features with text callouts
- Smooth camera movements

15-second intro:
- 0-5s: Logo fade in
- 5-10s: Tagline appears
- 10-15s: Transition to main content

Professional corporate video with:
- Clean, minimalist design
- Corporate blue color scheme
- Confident, trustworthy tone
- Smooth, elegant transitions

Use the company logo I uploaded earlier.
Overlay it on a gradient background with subtle animation.

​
Common Use Cases

For the Features chapter, create a video highlighting our top 3 features with icons and descriptions

Update the intro to be more engaging - add upbeat background music and faster animations

Create content for all 5 chapters with these themes: intro, problem, solution, features, CTA

​
Behavior Notes

Auto-creates chapters: If the chapter with the specified title doesn’t exist, it will be created automatically.
Blocking operation: This tool waits for completion (up to 30 seconds). For longer processing times, use the REST API’s non-blocking approach.
Force parameter: Use force: true to override an existing processing prompt, but this may interrupt ongoing work.

​
REST API Equivalent

This tool calls:
  1. POST /api/v1/projects/{projectId}/chapters (if chapter doesn’t exist)
  2. POST /api/v1/projects/{projectId}/chapters/{chapterId}/prompt
  3. Polls GET /api/v1/projects/{projectId}/chapters/{chapterId} for completion
See the Submit Prompt API documentation for more details.