What You’ll Learn
Text to Video
Transform written content into engaging videos
Auto Visuals
AI selects visuals based on your text content
Scene Control
Control how text is split into scenes
Job Monitoring
Track video creation progress in real-time
Before You Begin
Make sure you have:- A Pictory API key (get one here)
- Node.js or Python installed on your machine
- The required packages installed
Step-by-Step Guide
Step 1: Set Up Your Request
First, prepare your API credentials and the text you want to convert:Step 2: Create the Video
Send your text to the API to start the video creation process:Step 3: Monitor Progress
Check the status of your video until it’s ready:Understanding the Parameters
Required Parameters
| Parameter | Type | Description |
|---|---|---|
videoName | string | A unique name for your video project (used for organization) |
scenes | array | List of scenes to include in your video (minimum 1 scene) |
scenes[].story | string | The text content that will be converted to video |
Scene Control Options
| Parameter | Type | Default | Description |
|---|---|---|---|
createSceneOnNewLine | boolean | false | Creates a new scene at each line break in your text |
createSceneOnEndOfSentence | boolean | false | Creates a new scene at the end of each sentence |
How Scene Creation Works
The AI automatically determines scene breaks based on your settings:Both Options Enabled (Recommended for Social Media)
Only Sentence Breaks
Only Line Breaks
No Automatic Breaks
What Happens Behind the Scenes
When you submit your text, Pictory’s AI:- Analyzes Your Text - Understands the context and key concepts
- Breaks Into Scenes - Splits text based on your scene settings
- Selects Visuals - Automatically chooses relevant stock images/videos for each scene
- Generates Captions - Creates animated text overlays synchronized with the content
- Renders Video - Compiles everything into a polished video file
Processing Time: Videos typically take 3-10 minutes to create, depending on length. The API processes asynchronously, so you’ll receive a job ID immediately and can check status periodically.
Understanding the Response
Initial Response (Job Created)
Completed Response
Common Use Cases
Marketing Content
Educational Videos
Social Media Posts
Troubleshooting Common Issues
❌ Error: 'Invalid API Key'
❌ Error: 'Invalid API Key'
Problem: Your API key is incorrect or expired.Solution:
- Check that your API key starts with
pictai_ - Verify your subscription is active at API Access page
- Make sure you’re passing it in the
Authorizationheader
⏱️ Video stuck at 'in-progress' for over 30 minutes
⏱️ Video stuck at 'in-progress' for over 30 minutes
Problem: The job may have encountered an issue.Solution:
- Check the job status one more time
- Verify your text content isn’t excessively long (keep under 5,000 characters for best results)
- Contact support with your job ID if it’s been over an hour
❌ Error: 'Story text is required'
❌ Error: 'Story text is required'
Problem: The
story field is empty or missing.Solution:
Ensure each scene has a story field with actual text content:🎬 Scenes don't break where I expect
🎬 Scenes don't break where I expect
Problem: Scene creation settings don’t match your expectations.Solution:
- Review the scene control options above
- Test with both
createSceneOnNewLineandcreateSceneOnEndOfSentenceset totruefor maximum control - Use manual line breaks (
\n) in your text where you want scene breaks
Next Steps
Now that you know the basics, enhance your videos with these features:Add AI Voice-Over
Add professional narration to your videos
Customize Captions
Translate or customize subtitle text
AI-Generated Visuals
Use AI to generate unique visuals instead of stock
Apply Brand Settings
Add your logo, colors, and fonts automatically
