Creatomate API

Cloud API for generating and editing video and images programmatically. Creatomate uses a JSON-based format called RenderScript to define video/image compositions.

Quick Start

const Creatomate = require('creatomate');
const client = new Creatomate.Client('YOUR_API_KEY');

// Render from a template
const renders = await client.render({
  templateId: 'your-template-id',
  modifications: {
    'Title': 'Hello World',
    'Text 1': 'Dynamic content here'
  }
});

// Or build from source
const source = new Creatomate.Source({
  outputFormat: 'mp4',
  width: 1920,
  height: 1080,
  elements: [
    new Creatomate.Video({ source: 'https://...' }),
    new Creatomate.Text({ text: 'Overlay text' })
  ]
});
const renders = await client.render({ source });

Quick Reference

Task	Read
Getting started with the SDK	sdk-basics.md
Building video from elements	source-elements.md
Text overlays and animations	text-elements.md
Working with templates	templates.md
Transitions and effects	effects.md
Creating slideshows	slideshows.md
Adding captions/subtitles	captions.md
Social media formats	social-media.md
Compositions (scenes)	compositions.md
AI integration (ChatGPT)	ai-integration.md

Reference Files

Foundation

• references/sdk-basics.md - Client setup, API key, rendering basics
• references/source-elements.md - Source object, element types, tracks

Elements

• references/text-elements.md - Text styling, fonts, backgrounds, animations
• references/video-audio.md - Video/Audio elements, trimming, looping
• references/images.md - Image elements, slideshows, Ken Burns effects

Effects & Animations

• references/effects.md - Filters, blur, masks, color overlays, shadows
• references/animations.md - Keyframes, transitions, enter/exit animations
• references/captions.md - Animated captions, AWS Transcribe integration

Advanced

• references/compositions.md - Grouping elements, scenes, nested timelines
• references/templates.md - Using templates with modifications
• references/social-media.md - TikTok, Instagram, YouTube formats
• references/ai-integration.md - ChatGPT integration, AI-generated content

Code Examples

For 50+ working code examples, see the official Creatomate Node.js Examples repository.

Popular Examples

Example	Description
concatenate	Combine multiple videos
slideshow	Image slideshow with transitions
captions	Animated captions with AWS Transcribe
chatgpt	AI-generated video content
story-video	TikTok/Instagram story format
text-overlay	Text on video
picture-in-picture	PiP layout
aws-polly	Text-to-speech videos
blur-background	Background blur effect
template	Template rendering