Skip to main content
This guide shows you how to turn written text into an engaging video with automatically selected visuals. Perfect for creating social media content, educational videos, or marketing materials from your written content.

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
  • 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 is ready:

Understanding the Parameters

Required Parameters

ParameterTypeDescription
videoNamestringA unique name for your video project (used for organization)
scenesarrayList of scenes to include in your video (minimum 1 scene)
scenes[].storystringThe text content that will be converted to video

Scene Control Options

ParameterTypeDefaultDescription
createSceneOnNewLinebooleanfalseCreates a new scene at each line break in your text
createSceneOnEndOfSentencebooleanfalseCreates a new scene at the end of each sentence
Scene Creation Best Practices:
  • For short, punchy videos (like social media): Set both createSceneOnNewLine and createSceneOnEndOfSentence to true
  • For longer, narrative videos: Set both to false to keep related content together
  • For paragraph-based content: Set createSceneOnNewLine to true only

How Scene Creation Works

The AI automatically determines scene breaks based on your settings:
Result: Maximum scene breaks - new scene for each sentence AND paragraph Best for: Short-form content, social media clips, dynamic videos

Only Sentence Breaks

Result: New scene at each sentence, paragraphs stay together Best for: Educational content, explainer videos

Only Line Breaks

Result: New scene at each paragraph/line break Best for: Article-to-video, blog content

No Automatic Breaks

Result: All text stays in one scene Best for: Short quotes, single-thought videos

What Happens Behind the Scenes

When you submit your text, Pictory’s AI:
  1. Analyzes Your Text - Understands the context and key concepts
  2. Breaks Into Scenes - Splits text based on your scene settings
  3. Selects Visuals - Automatically chooses relevant stock images/videos for each scene
  4. Generates Captions - Creates animated text overlays synchronized with the content
  5. 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 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

Problem: Your API key is incorrect or expired.Solution:
  1. Check that your API key starts with pictai_
  2. Verify your subscription is active at API Access page
  3. Make sure you are passing it in the Authorization header
Problem: The job may have encountered an issue.Solution:
  1. Check the job status one more time
  2. Verify your text content is not excessively long (keep under 5,000 characters for best results)
  3. Contact support with your job ID if it has been over an hour
Problem: The story field is empty or missing.Solution: Ensure each scene has a story field with actual text content:
Problem: Scene creation settings do not match your expectations.Solution:
  • Review the scene control options above
  • Test with both createSceneOnNewLine and createSceneOnEndOfSentence set to true for 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

API Reference

For complete technical details, see:

Render Storyboard Video

Direct video rendering from text (used in this guide)

Create Storyboard Preview

Create preview before rendering

Get Storyboard Preview Job

Monitor storyboard creation progress

Get Text Styles

Customize subtitle appearance