Themes & Config
Customize video appearance using themes and configuration parameters.
List Themes
GET /themes
bash
curl https://api.sketchpen.app/api/v1/themes
Response:
json
[
{
"id": "presentation",
"name": "Standard Presentation",
"description": "Clean, educational style suitable for tutorials."
}
]Use the id field value as the theme parameter when creating videos.
Using Themes
bash
# Create a video with custom configuration
curl -X POST https://api.sketchpen.app/api/v1/videos \
-H "X-Api-Key: sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"prompt": "A product demo for a mobile app onboarding flow",
"theme": "presentation",
"bg_mode": "dynamic",
"aspect_ratio": "9:16",
"fps": 24
}'The theme controls the visual style of the video. The bg_mode controls background colors:
white— Clean white background (default)dynamic— Theme-based colors that cycle per scene
Video Configuration
When creating a video, you can customize various parameters:
| Field | Type | Default | Description |
|---|---|---|---|
| `prompt` | string | - | Natural language description of the video (required, max 2000 chars) |
| `aspect_ratio` | string | 16:9 | Video aspect ratio: 16:9, 9:16, 1:1 |
| `fps` | integer | 24 | Frames per second (1-60) |
| `theme` | string | presentation | Theme ID (see /themes endpoint) |
| `voice_id` | string | - | Voice ID for narration |
| `audio_mode` | string | single | Audio mode: none, single, multi_voice |
| `bg_mode` | string | white | Background mode: white, dynamic |
ℹ️ Video Limits
Max 40 scenes per video. Each scene costs 1 credit.
Audio Mode
| Mode | Description |
|---|---|
| `none` | No audio generated |
| `single` | Single narrator voice throughout |
| `multi_voice` | Multiple voices for dialogue scenes |
Aspect Ratio
| Ratio | Dimensions | Use Case |
|---|---|---|
| `16:9` | 1920x1080 | Standard landscape (YouTube, web) |
| `9:16` | 1080x1920 | Vertical (TikTok, Reels, Shorts) |
| `1:1` | 1080x1080 | Square (Instagram feed) |
Background Mode
| Mode | Description |
|---|---|
| `white` | Clean white background (default) |
| `dynamic` | Theme-based colors that cycle through a palette for each scene |
Dynamic Palette
When using dynamic mode, the engine cycles through the following default pastel colors per scene:
Warm cream
#F5F5DC
Soft sky blue
#E6F0FA
Blush pink
#F5EBF0
Mint green
#EBF5EB
Warm peach
#FAF5E6
Soft lavender
#F0EBFA
Warm ivory
#FAF8E6
Light teal
#E6F5F5