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 |