isfendipgensin/creatomate

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 |