json2video-pinterest

# JSON2Video Pinterest Skill

Generate vertical videos (1080x1920) optimized for Pinterest using the JSON2Video API.

## Prerequisites

1. **JSON2Video API Key**: Sign up at https://json2video.com/get-api-key/
2. **Set Environment Variable**:
   ```bash
   export JSON2VIDEO_API_KEY="your_api_key_here"
   ```

## Quick Start

Create a video using a JSON configuration file:

```bash
python3 scripts/generate_video.py --config my-video.json --wait
```

## Configuration Format

The video is defined as an array of scenes. Each scene contains:

| Property | Type | Description |
|----------|------|-------------|
| `image` | object | Image configuration (AI-generated or URL) |
| `voice` | object | Voice configuration (generated TTS or URL) |
| `text_overlay` | string | Optional text displayed on scene |
| `subtitles` | boolean | Enable/disable subtitles |
| `zoom_effect` | boolean | Add Ken Burns zoom effect |
| `duration` | number | Override scene duration (seconds) |

### Image Configuration

**AI-Generated Image:**
```json
{
  "image": {
    "source": "ai",
    "ai_provider": "flux-schnell",
    "ai_prompt": "A minimalist workspace with laptop..."
  }
}
```

**Available AI Providers:**
- `flux-pro` - Highest quality, realistic images
- `flux-schnell` - Fast generation, good quality
- `freepik-classic` - Digital artwork style

**URL-Based Image:**
```json
{
  "image": {
    "source": "https://example.com/image.jpg"
  }
}
```

### Voice Configuration

**AI-Generated Voice (TTS):**
```json
{
  "voice": {
    "source": "generated",
    "text": "Your voiceover text here",
    "voice_id": "en-US-EmmaMultilingualNeural",
    "model": "azure"
  }
}
```

**Provided Audio File:**
```json
{
  "voice": {
    "source": "https://example.com/voiceover.mp3"
  }
}
```

**Note on Scene Duration**: The voiceover determines scene length automatically. Each scene's duration matches its audio length. For provided audio files, ensure they match your intended scene timing.

### Complete Example...