Render Video from Preview
Videos
Render Video from Preview
Render final video from an existing storyboard preview job output
PUT
Render Video from Preview
Documentation Index
Fetch the complete documentation index at: https://docs.pictory.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Render from Preview API generates the final video file from an existing storyboard preview. This endpoint is part of the recommended two-step workflow: first create a preview to review and validate content, then render the final video once approved.This endpoint requires a completed storyboard preview job ID. First use the Create Storyboard Preview API to generate a preview, then use this endpoint to render the final video.
Render Workflow Options
| Workflow | API | When to Use |
|---|---|---|
| Create Preview | Create Storyboard Preview | Generate preview to review scenes before rendering |
| Render from Preview | This API | Render preview as-is without modifications |
| Render with Modifications | Render Video | Modify preview elements before rendering |
| Render Saved Project | Render Project | Render existing project created in App or via API |
| Direct Render | Render Storyboard Video | Skip preview, render directly from input |
Benefits of Two-Step Workflow
Content Validation
Review scenes, visuals, and timing before committing to render
Cost Optimization
Only render videos that have been reviewed and approved
Iterative Refinement
Make adjustments to the preview before final render
Quality Assurance
Ensure content meets requirements before production
API Endpoint
Request Parameters
Path Parameters
The job ID returned from a completed Create Storyboard Preview request. This ID identifies the storyboard configuration to render.
Headers
API key for authentication
Must be
application/jsonRequest Body Parameters
The request body allows you to override or add settings from the original storyboard preview. All parameters are optional - if not provided, the original preview settings are used.URL where the completed video output will be sent via POST request when finished (max 500 characters). Overrides the webhook from the preview.
Response
When the render request is successfully submitted, a job is created and a job ID is returned.Indicates whether the request was successful
Unique identifier for the render job. Use this to track the job status and retrieve results via the Get Video Render Job by ID endpoint.
Next Steps
Once you have thejobId, poll the Get Video Render Job by ID endpoint to check the render status and retrieve the output URLs when complete. Use a polling interval of 10–30 seconds.
Code Examples
Basic Render from Preview
Render with Webhook Notification
Complete Two-Step Workflow
Error Handling
400 - Invalid Storyboard Job ID
400 - Invalid Storyboard Job ID
404 - Storyboard Not Found
404 - Storyboard Not Found
400 - Preview Not Completed
400 - Preview Not Completed
401 - Unauthorized
401 - Unauthorized
Related APIs
Create Storyboard Preview
Generate preview before rendering (Step 1)
Render Storyboard Video
Direct render without preview step
Get Render Job Status
Monitor rendering progress
Get Projects
List saved video projects
