Skip to main content

​
Welcome to Pictory API

The Pictory API enables developers to integrate AI-powered video creation and editing capabilities directly into their applications. Build automated video workflows, create personalized video content at scale, and leverage Pictory’s advanced features programmatically.

Get Your API Key

Access your API key from the Pictory dashboard

​
What You Can Build

The Pictory API provides comprehensive access to create and manage video content:

Storyboard

Create storyboard preview or render storyboard video

Video Templates

Build reusable templates for consistent video production

Transcription & AI

Generate transcripts and AI-powered video summaries

Branding & Styling

Apply custom fonts, styles, and brand configurations

Media Management

Search and manage media assets for your videos

VoiceOvers & Music

Add professional audio tracks and background music

Cloud Integrations

Connect with AWS S3 and Vimeo for storage and hosting

Job Monitoring

Track asynchronous processing tasks and results

​
Quick Start

Get started with the Pictory API in three simple steps:
1

Get Your API Key

Sign up for a Pictory account and obtain your API key from the API Access page.Your API key will start with pictai_ and must be kept secure.
2

Make Your First Request

Test your API key by fetching your projects:
curl --request GET \
  --url 'https://api.pictory.ai/pictoryapis/v2/projects' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'accept: application/json'
3

Create Your First Video

Create a text-to-video storyboard preview:
curl --request POST \
  --url 'https://api.pictory.ai/pictoryapis/v2/video/storyboard' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "videoName": "my_first_video",
    "scenes": [
      {
        "story": "Welcome to Pictory! This is your first AI-generated video. Turn any text into engaging video content in seconds.",
        "createSceneOnEndOfSentence": true
      }
    ]
  }'
This returns a jobId that you can use to check the status and get the preview output.
4

Check Job Status

Poll the job status to get your video preview:
curl --request GET \
  --url 'https://api.pictory.ai/pictoryapis/v1/jobs/{jobId}' \
  --header 'Authorization: YOUR_API_KEY'
When status is completed, you’ll receive the preview output with scene thumbnails and renderParams.
5

Explore the API

Browse the API reference documentation to discover all available endpoints and capabilities.

​
Base URL

All API endpoints use the following base URL: 
https://api.pictory.ai/pictoryapis
Critical: Use the Correct API VersionDifferent endpoints use different API versions (/v1/ or /v2/). Always verify you’re using the correct version for each endpoint.

​
Authentication

All API requests must be authenticated using your API key in the Authorization header.

​
API Key Format

Authorization: pictai_your_api_key_here
Keep Your API Key Secure: Never expose your API key in client-side code, public repositories, or unsecured locations. Use environment variables and secure secret management.

​
Common Workflows

Explore these popular workflows to get started quickly:

Text to Video with AI Voice-Over

Turn text into engaging videos with natural-sounding AI narration

Blog URL to Video with AI Voice-Over

Transform blog articles into video content with AI voice narration

Podcast/Audio to Video

Convert podcast episodes and audio files into visual content

AI-Generated Visuals

Create videos with AI-generated images and visuals
If you encounter rate limiting (HTTP 429), implement exponential backoff retry logic in your application.

​
Best Practices

​
Security

  1. Secure API Keys: Store keys in environment variables or secret managers
  2. Rotate Keys: Periodically rotate API keys for enhanced security

​
Performance

  1. Cache Static Data: Cache fonts, styles, and brands locally
  2. Batch Operations: Group related API calls when possible

​
Stay Connected

Join our community and stay updated with the latest features, tips, and announcements:

X (Twitter)

Get real-time updates, tips, and product announcements

LinkedIn

Professional insights, company news, and industry trends

Instagram

Visual inspiration, video tips, and creative content

YouTube

Video tutorials, feature demos, and how-to guides

Facebook

Join 20,000+ creators sharing tips and success stories

Reddit

Join our Reddit community for discussions and updates

Discord

Chat with developers, get quick help, and share feedback