Image Handling Skill
Right format, right size, right quality.
Format Selection
| Format |
Best For |
Supports |
| SVG |
Icons, logos, diagrams |
Infinite scale, animation |
| PNG |
Screenshots, transparency |
Lossless, alpha channel |
| JPEG |
Photos, gradients |
Small size, no transparency |
| WebP |
Web images |
Best compression, both |
| ICO |
Favicons |
Multi-resolution |
Conversion Commands
# SVG to PNG using sharp-cli (recommended)
# --density sets DPI for vector rendering (150 = crisp text)
npx sharp-cli -i input.svg -o output-folder/ --density 150 -f png
# Note: output must be a directory, filename preserved from input
npx sharp-cli -i banner.svg -o assets/ --density 150 -f png
# Creates: assets/banner.png
# ImageMagick (if installed)
magick input.svg -resize 512x512 output.png
magick input.png -quality 85 output.jpg
# Multiple sizes
foreach ($size in 16,32,64,128,256,512) {
magick input.svg -resize ${size}x${size} "icon-$size.png"
}
SVG to PNG Tips
- Emojis don't convert well - Use text-only or SVG icons
- Use
--density 150+ for crisp text rendering
- Check file size - README banners should be < 500KB
GitHub README Images
<!-- Absolute URL (always works) -->

<!-- Relative (works in repo) -->

<!-- With dark/light variants -->
<picture>
<source media="(prefers-color-scheme: dark)" srcset="banner-dark.svg">
<img src="banner-light.svg" alt="Banner">
</picture>
Size Guidelines
| Use Case |
Max Size |
Recommended |
| README banner |
500KB |
< 100KB |
| Documentation |
200KB |
< 50KB |
| Icons |
50KB |
< 10KB |
| Favicon |
10KB |
< 5KB |
Optimization
# PNG optimization
pngquant --quality=65-80 input.png -o output.png
# JPEG optimization
jpegoptim --max=85 input.jpg
# SVG optimization
npx svgo input.svg -o output.svg
Batch Processing
# Convert all SVGs to PNGs
Get-ChildItem *.svg | ForEach-Object {
$out = $_.BaseName + ".png"
magick $_.Name -resize 256x256 $out
}
Replicate Model Selection
Match user intent to the right model. When a user names a specific model or describes a need, use this table.
| Model |
Replicate ID |
Cost |
Best For |
Trigger Words |
| Flux Schnell |
black-forest-labs/flux-schnell |
$0.003 |
Fast iteration, prototyping |
"flux schnell", "quick image", "fast generation" |
| Flux Dev |
black-forest-labs/flux-dev |
$0.025 |
High quality no-text images |
"flux dev", "high quality image" |
| Flux 1.1 Pro |
black-forest-labs/flux-1.1-pro |
$0.04 |
Production, photorealistic |
"flux pro", "flux 1.1", "production image" |
| Flux 2 Pro |
black-forest-labs/flux-2-pro |
~$0.05+ |
High quality with reference images (up to 8 refs), text rendering |
"flux 2", "flux-2-pro", "high quality refs" |
| Flux 2 Max |
black-forest-labs/flux-2-max |
higher |
Highest fidelity BFL output |
"flux 2 max", "highest quality" |
| Flux Kontext Pro |
black-forest-labs/flux-kontext-pro |
$0.04 |
Text-based image editing, style transfer, outfit changes |
"edit image", "kontext", "change background", "outfit" |
| Flux Kontext Max |
black-forest-labs/flux-kontext-max |
$0.08 |
Premium editing + improved typography in edited images |
"kontext max", "premium edit" |
| Ideogram v2 |
ideogram-ai/ideogram-v2 |
$0.08 |
Banner typography (proven, stable API) |
"ideogram v2", "banner with text" |
| Ideogram v3 Turbo |
ideogram-ai/ideogram-v3-turbo |
$0.03 |
Fast typography generation |
"ideogram turbo", "fast text image", "ideogram v3" |
| Ideogram v3 Balanced |
ideogram-ai/ideogram-v3-balanced |
$0.06 |
Balanced quality/speed typography |
"ideogram balanced" |
| Ideogram v3 Quality |
ideogram-ai/ideogram-v3-quality |
$0.09 |
Highest quality typography |
"ideogram quality", "best ideogram" |
| Nano-Banana Pro |
google/nano-banana-pro |
$0.025 |
Face-consistent portraits with reference photos (up to 14 refs), 4K |
"nano-banana", "face consistency", "portrait", "reference photo" |
| Nano-Banana 2 |
google/nano-banana-2 |
$0.067/1K |
Faster alternative to nano-banana-pro, same 14-ref API |
"nano-banana-2", "fast portrait", "gemini flash image" |
| SDXL |
stability-ai/sdxl |
$0.009 |
Classic diffusion, LoRA styles |
"sdxl", "stable diffusion", "stable diffusion xl" |
| Seedream 5 Lite |
bytedance/seedream-5-lite |
varies |
2K/3K with built-in reasoning, example-based editing |
"seedream", "bytedance", "high resolution" |
| Recraft v4 |
recraft-ai/recraft-v4 |
varies |
Design taste, strong composition, text rendering |
"recraft", "design image", "art directed" |
| Recraft v4 SVG |
recraft-ai/recraft-v4-svg |
varies |
Production-ready SVG vector images |
"recraft svg", "vector", "generate svg" |
| Recraft v4 Pro SVG |
recraft-ai/recraft-v4-pro-svg |
$0.30 |
High quality SVG with detailed paths |
"recraft pro svg", "detailed svg" |
Model Selection Guide
- "quick" / "test" / "prototype" → Flux Schnell ($0.003, 4 steps)
- "high quality" / "production" → Flux 1.1 Pro ($0.04) or Flux 2 Pro for multi-ref
- Text must appear in the image → Ideogram v3 Turbo ($0.03) or v3 Quality ($0.09); v2 still works
- Simple/fast text in image → Ideogram v3 Turbo ($0.03, fastest + cheapest)
- Edit an existing image → Flux Kontext Pro ($0.04, text-prompted editing)
- Premium image editing → Flux Kontext Max ($0.08, better typography in edits)
- Painting style / custom LoRA → SDXL or Flux Dev with LoRA weights
- Largest / highest resolution output → Seedream 5 Lite (up to 3K) or Nano-Banana Pro (up to 4K)
- README banner (default, SVG) → Recraft v4 SVG (
recraft-ai/recraft-v4-svg, native SVG output, scalable); see ai-generated-readme-banners skill
- README banner (premium SVG) → Recraft v4 Pro SVG ($0.30, detailed vector paths)
- README banner (raster, with text) → Ideogram v3 Turbo
3:1 ratio ($0.03)
- README banner (raster, no text) → Flux 1.1 Pro with
21:9 ratio
- Face-consistent portraits (fast) → Nano-Banana 2 ($0.067/1K,
image_input array, same API as Pro)
- Face-consistent portraits (quality) → Nano-Banana Pro ($0.025,
image_input up to 14 refs)
- Multi-reference high quality → Flux 2 Pro (~$0.05+,
input_images up to 8 refs)
- Highest fidelity → Flux 2 Max
- Vector/SVG logo or graphic → Recraft v4 SVG (native SVG output) or Recraft v4 Pro SVG ($0.30)
- Art-directed design → Recraft v4 (strong composition, design taste)
- Short video clip (≤8s) → Veo-3.1-fast (faster/cheaper successor to Veo-3, auto audio)
- Longer video (≤15s) → Grok Video (
xai/grok-imagine-video, $0.05/sec, auto audio + lip-sync)
- Cinematic video → Kling v3 (
kwaivgi/kling-v3-video, 1080p, multi-shot, ≤15s)
- Realistic home-video quality → Sora-2 (
openai/sora-2, synced audio)
LoRA Support (Flux Dev / SDXL)
Both Flux Dev and SDXL accept LoRA weights:
// Replicate format
extra_lora: "fofr/flux-pixar-cars"
// HuggingFace format
extra_lora: "huggingface.co/owner/model-name"
// CivitAI format
extra_lora: "civitai.com/models/<id>"
// Direct URL
extra_lora: "https://example.com/weights.safetensors"
Aspect Ratio Reference
| Ratio |
Models |
Use Case |
21:9 |
Flux (all) |
Ultra-wide README banner |
3:1 |
Ideogram |
Wide banner with typography |
16:9 |
All |
Standard widescreen |
1:1 |
All |
Square, avatar, icon |
9:16 |
All |
Mobile, portrait |
Face Reference Models
For character/portrait consistency across multiple generations, use models that accept reference images:
Nano-Banana Pro (Recommended for Portraits)
const output = await replicate.run("google/nano-banana-pro", {
input: {
prompt: "Description of desired scene",
image_input: referenceImageURIs, // Array of data URIs (up to 14)
aspect_ratio: "3:4",
output_format: "png",
}
});
Key: image_input accepts an array of data URIs. More references = better face consistency.
Flux 2 Pro (Higher Quality Alternative)
const output = await replicate.run("black-forest-labs/flux-2-pro", {
input: {
prompt: "Description of desired scene",
input_images: referenceImageURIs, // Array of data URIs (up to 8)
aspect_ratio: "3:4",
output_format: "png",
}
});
Key: input_images (not image_input) — different parameter name from nano-banana.
Preparing Reference Photos
# Resize to 512px @ 85% quality for optimal API performance
magick input.jpg -resize 512x512 -quality 85 output.jpg
# Convert to base64 data URI (for embedding in visual memory)
[Convert]::ToBase64String([IO.File]::ReadAllBytes("photo.jpg")) | Set-Clipboard
Optimal reference specs: 512px longest edge, 85% JPEG quality, ~40-80KB per photo.
Video Generation Models
Generate video from a still image or text prompt via Replicate. All video models support image-to-video workflows.
| Model |
Replicate ID |
Cost |
Duration |
Audio |
Best For |
| Veo-3 |
google/veo-3 |
$0.50/video |
4, 6, or 8s only |
✅ Auto |
Short clips with synced audio |
| Veo-3.1-fast |
google/veo-3.1-fast |
lower |
4-8s |
✅ Context-aware audio |
Newer/faster Veo 3, last-frame support |
| Veo-3.1 |
google/veo-3.1 |
higher |
4-8s |
✅ Context-aware audio |
Highest fidelity successor to Veo 3 |
| Grok Video |
xai/grok-imagine-video |
$0.05/sec |
1-15s |
✅ Auto (music, SFX, lip-sync) |
Longer videos, best audio |
| Kling v3 |
kwaivgi/kling-v3-video |
$0.22/sec |
3-15s |
✅ Native |
Cinematic quality, 1080p, multi-shot |
| Kling v3 Omni |
kwaivgi/kling-v3-omni-video |
varies |
3-15s |
✅ Native |
Multi-modal: text, ref image, editing |
| Sora-2 |
openai/sora-2 |
varies |
flexible |
✅ Synced |
Home-video realism, flexible prompting |
| WAN 2.5 fast |
wan-video/wan-2.5-t2v-fast |
low |
5-10s |
❌ |
Open-source, fast, cost-effective |
Duration Constraints
| Model |
Min |
Max |
Notes |
| Veo-3 |
4s |
8s |
Only accepts 4, 6, or 8 — other values rejected |
| Grok Video |
1s |
15s |
Flexible, any integer |
| Kling v3 |
3s |
15s |
Modes: standard (720p), pro (1080p) |
Video Generation Pattern
Typical workflow: generate a still image first, then animate it:
// Step 1: Generate still image
const image = await replicate.run("google/nano-banana-pro", {
input: { prompt: "Person smiling at camera", image_input: refs }
});
// Step 2: Animate to video
const video = await replicate.run("google/veo-3", {
input: {
prompt: "Head turns slowly, smile widens, warm natural lighting",
image: imageUrl,
duration: 6
}
});
Cloud TTS Models (Replicate)
For content creation (audiobooks, narration, voice cloning), Replicate offers paid TTS models that complement the free Edge TTS in the extension.
| Model |
Replicate ID |
Cost |
Voice Cloning |
Languages |
Best For |
| Speech Turbo |
minimax/speech-2.8-turbo |
$0.06/1k tokens |
❌ |
40+ |
Fast, expressive, many voices |
| Chatterbox Turbo |
resemble-ai/chatterbox-turbo |
$0.025/1k chars |
✅ (5s sample) |
English |
Voice cloning, natural pauses |
| Qwen TTS |
qwen/qwen3-tts |
$0.02/1k chars |
✅ |
10 |
Voice design from description |
Voice Presets
Speech Turbo: Wise_Woman, Deep_Voice_Man, Casual_Guy, Lively_Girl, Young_Knight, Abbess, + 6 more
Chatterbox: Andy, Luna, Ember, Aurora, Cliff, Josh, William, Orion, Ken
Qwen TTS: Aiden, Dylan, Eric, Serena, Vivian, + 4 more
Emotion Control (Speech Turbo)
Supported emotions: auto, happy, sad, angry, fearful, disgusted, surprised
Voice Cloning (Chatterbox / Qwen)
Provide a 5+ second audio sample to clone a voice:
const output = await replicate.run("resemble-ai/chatterbox-turbo", {
input: {
text: "Content to speak in the cloned voice",
audio_prompt: referenceAudioDataURI // 5+ seconds WAV/MP3
}
});
Voice Design (Qwen TTS)
Create a voice from a natural language description:
const output = await replicate.run("qwen/qwen3-tts", {
input: {
text: "Content to speak",
tts_mode: "voice_design",
voice_description: "A warm, friendly female voice with a slight British accent"
}
});
When to Use Cloud TTS vs Edge TTS
| Scenario |
Recommended |
Why |
| Read document in VS Code |
Edge TTS (extension) |
Free, instant, integrated |
| Create audiobook narration |
Replicate TTS |
Higher quality, voice cloning |
| Generate voice for video |
Replicate TTS |
Emotion control, design voices |
| Multi-language content creation |
Either |
Edge has 32 languages; Speech Turbo has 40+ |
Synapses
See synapses.json for connections.
1---2name: image-handling-43description: "Right format, right size, right quality — plus AI image generation via Replicate"4metadata:5 source: https://skillmd.com/skills/fabioc-aloha/image-handling-46---78# Image Handling Skill910> Right format, right size, right quality.1112## Format Selection1314| Format | Best For | Supports |15| ------ | -------- | -------- |16| SVG | Icons, logos, diagrams | Infinite scale, animation |17| PNG | Screenshots, transparency | Lossless, alpha channel |18| JPEG | Photos, gradients | Small size, no transparency |19| WebP | Web images | Best compression, both |20| ICO | Favicons | Multi-resolution |2122## Conversion Commands2324```powershell25# SVG to PNG using sharp-cli (recommended)26# --density sets DPI for vector rendering (150 = crisp text)27npx sharp-cli -i input.svg -o output-folder/ --density 150 -f png2829# Note: output must be a directory, filename preserved from input30npx sharp-cli -i banner.svg -o assets/ --density 150 -f png31# Creates: assets/banner.png3233# ImageMagick (if installed)34magick input.svg -resize 512x512 output.png35magick input.png -quality 85 output.jpg3637# Multiple sizes38foreach ($size in 16,32,64,128,256,512) {39 magick input.svg -resize ${size}x${size} "icon-$size.png"40}41```4243## SVG to PNG Tips4445- **Emojis don't convert well** - Use text-only or SVG icons46- **Use `--density 150+`** for crisp text rendering47- **Check file size** - README banners should be < 500KB4849## GitHub README Images5051```markdown52<!-- Absolute URL (always works) -->535455<!-- Relative (works in repo) -->565758<!-- With dark/light variants -->59<picture>60 <source media="(prefers-color-scheme: dark)" srcset="banner-dark.svg">61 <img src="banner-light.svg" alt="Banner">62</picture>63```6465## Size Guidelines6667| Use Case | Max Size | Recommended |68| -------- | -------- | ----------- |69| README banner | 500KB | < 100KB |70| Documentation | 200KB | < 50KB |71| Icons | 50KB | < 10KB |72| Favicon | 10KB | < 5KB |7374## Optimization7576```powershell77# PNG optimization78pngquant --quality=65-80 input.png -o output.png7980# JPEG optimization81jpegoptim --max=85 input.jpg8283# SVG optimization84npx svgo input.svg -o output.svg85```8687## Batch Processing8889```powershell90# Convert all SVGs to PNGs91Get-ChildItem *.svg | ForEach-Object {92 $out = $_.BaseName + ".png"93 magick $_.Name -resize 256x256 $out94}95```9697## Replicate Model Selection9899Match user intent to the right model. When a user names a specific model or describes a need, use this table.100101| Model | Replicate ID | Cost | Best For | Trigger Words |102|-------|-------------|------|----------|---------------|103| **Flux Schnell** | `black-forest-labs/flux-schnell` | $0.003 | Fast iteration, prototyping | "flux schnell", "quick image", "fast generation" |104| **Flux Dev** | `black-forest-labs/flux-dev` | $0.025 | High quality no-text images | "flux dev", "high quality image" |105| **Flux 1.1 Pro** | `black-forest-labs/flux-1.1-pro` | $0.04 | Production, photorealistic | "flux pro", "flux 1.1", "production image" |106| **Flux 2 Pro** | `black-forest-labs/flux-2-pro` | ~$0.05+ | High quality with reference images (up to 8 refs), text rendering | "flux 2", "flux-2-pro", "high quality refs" |107| **Flux 2 Max** | `black-forest-labs/flux-2-max` | higher | Highest fidelity BFL output | "flux 2 max", "highest quality" |108| **Flux Kontext Pro** | `black-forest-labs/flux-kontext-pro` | $0.04 | Text-based image editing, style transfer, outfit changes | "edit image", "kontext", "change background", "outfit" |109| **Flux Kontext Max** | `black-forest-labs/flux-kontext-max` | $0.08 | Premium editing + improved typography in edited images | "kontext max", "premium edit" |110| **Ideogram v2** | `ideogram-ai/ideogram-v2` | $0.08 | Banner typography (proven, stable API) | "ideogram v2", "banner with text" |111| **Ideogram v3 Turbo** | `ideogram-ai/ideogram-v3-turbo` | $0.03 | Fast typography generation | "ideogram turbo", "fast text image", "ideogram v3" |112| **Ideogram v3 Balanced** | `ideogram-ai/ideogram-v3-balanced` | $0.06 | Balanced quality/speed typography | "ideogram balanced" |113| **Ideogram v3 Quality** | `ideogram-ai/ideogram-v3-quality` | $0.09 | Highest quality typography | "ideogram quality", "best ideogram" |114| **Nano-Banana Pro** | `google/nano-banana-pro` | $0.025 | Face-consistent portraits with reference photos (up to 14 refs), 4K | "nano-banana", "face consistency", "portrait", "reference photo" |115| **Nano-Banana 2** | `google/nano-banana-2` | $0.067/1K | Faster alternative to nano-banana-pro, same 14-ref API | "nano-banana-2", "fast portrait", "gemini flash image" |116| **SDXL** | `stability-ai/sdxl` | $0.009 | Classic diffusion, LoRA styles | "sdxl", "stable diffusion", "stable diffusion xl" |117| **Seedream 5 Lite** | `bytedance/seedream-5-lite` | varies | 2K/3K with built-in reasoning, example-based editing | "seedream", "bytedance", "high resolution" |118| **Recraft v4** | `recraft-ai/recraft-v4` | varies | Design taste, strong composition, text rendering | "recraft", "design image", "art directed" |119| **Recraft v4 SVG** | `recraft-ai/recraft-v4-svg` | varies | Production-ready SVG vector images | "recraft svg", "vector", "generate svg" |120| **Recraft v4 Pro SVG** | `recraft-ai/recraft-v4-pro-svg` | $0.30 | High quality SVG with detailed paths | "recraft pro svg", "detailed svg" |121122### Model Selection Guide123124- **"quick" / "test" / "prototype"** → Flux Schnell ($0.003, 4 steps)125- **"high quality" / "production"** → Flux 1.1 Pro ($0.04) or Flux 2 Pro for multi-ref126- **Text must appear in the image** → Ideogram v3 Turbo ($0.03) or v3 Quality ($0.09); v2 still works127- **Simple/fast text in image** → Ideogram v3 Turbo ($0.03, fastest + cheapest)128- **Edit an existing image** → Flux Kontext Pro ($0.04, text-prompted editing)129- **Premium image editing** → Flux Kontext Max ($0.08, better typography in edits)130- **Painting style / custom LoRA** → SDXL or Flux Dev with LoRA weights131- **Largest / highest resolution output** → Seedream 5 Lite (up to 3K) or Nano-Banana Pro (up to 4K)132- **README banner (default, SVG)** → Recraft v4 SVG (`recraft-ai/recraft-v4-svg`, native SVG output, scalable); see `ai-generated-readme-banners` skill133- **README banner (premium SVG)** → Recraft v4 Pro SVG ($0.30, detailed vector paths)134- **README banner (raster, with text)** → Ideogram v3 Turbo `3:1` ratio ($0.03)135- **README banner (raster, no text)** → Flux 1.1 Pro with `21:9` ratio136- **Face-consistent portraits (fast)** → Nano-Banana 2 ($0.067/1K, `image_input` array, same API as Pro)137- **Face-consistent portraits (quality)** → Nano-Banana Pro ($0.025, `image_input` up to 14 refs)138- **Multi-reference high quality** → Flux 2 Pro (~$0.05+, `input_images` up to 8 refs)139- **Highest fidelity** → Flux 2 Max140- **Vector/SVG logo or graphic** → Recraft v4 SVG (native SVG output) or Recraft v4 Pro SVG ($0.30)141- **Art-directed design** → Recraft v4 (strong composition, design taste)142- **Short video clip (≤8s)** → Veo-3.1-fast (faster/cheaper successor to Veo-3, auto audio)143- **Longer video (≤15s)** → Grok Video (`xai/grok-imagine-video`, $0.05/sec, auto audio + lip-sync)144- **Cinematic video** → Kling v3 (`kwaivgi/kling-v3-video`, 1080p, multi-shot, ≤15s)145- **Realistic home-video quality** → Sora-2 (`openai/sora-2`, synced audio)146147### LoRA Support (Flux Dev / SDXL)148149Both Flux Dev and SDXL accept LoRA weights:150151```javascript152// Replicate format153extra_lora: "fofr/flux-pixar-cars"154// HuggingFace format155extra_lora: "huggingface.co/owner/model-name"156// CivitAI format157extra_lora: "civitai.com/models/<id>"158// Direct URL159extra_lora: "https://example.com/weights.safetensors"160```161162### Aspect Ratio Reference163164| Ratio | Models | Use Case |165|-------|--------|----------|166| `21:9` | Flux (all) | Ultra-wide README banner |167| `3:1` | Ideogram | Wide banner with typography |168| `16:9` | All | Standard widescreen |169| `1:1` | All | Square, avatar, icon |170| `9:16` | All | Mobile, portrait |171172## Face Reference Models173174For character/portrait consistency across multiple generations, use models that accept reference images:175176### Nano-Banana Pro (Recommended for Portraits)177178```javascript179const output = await replicate.run("google/nano-banana-pro", {180 input: {181 prompt: "Description of desired scene",182 image_input: referenceImageURIs, // Array of data URIs (up to 14)183 aspect_ratio: "3:4",184 output_format: "png",185 }186});187```188189**Key**: `image_input` accepts an **array** of data URIs. More references = better face consistency.190191### Flux 2 Pro (Higher Quality Alternative)192193```javascript194const output = await replicate.run("black-forest-labs/flux-2-pro", {195 input: {196 prompt: "Description of desired scene",197 input_images: referenceImageURIs, // Array of data URIs (up to 8)198 aspect_ratio: "3:4",199 output_format: "png",200 }201});202```203204**Key**: `input_images` (not `image_input`) — different parameter name from nano-banana.205206### Preparing Reference Photos207208```powershell209# Resize to 512px @ 85% quality for optimal API performance210magick input.jpg -resize 512x512 -quality 85 output.jpg211212# Convert to base64 data URI (for embedding in visual memory)213[Convert]::ToBase64String([IO.File]::ReadAllBytes("photo.jpg")) | Set-Clipboard214```215216Optimal reference specs: 512px longest edge, 85% JPEG quality, ~40-80KB per photo.217218---219220## Video Generation Models221222Generate video from a still image or text prompt via Replicate. All video models support image-to-video workflows.223224| Model | Replicate ID | Cost | Duration | Audio | Best For |225|-------|-------------|------|----------|-------|----------|226| **Veo-3** | `google/veo-3` | $0.50/video | 4, 6, or 8s only | ✅ Auto | Short clips with synced audio |227| **Veo-3.1-fast** | `google/veo-3.1-fast` | lower | 4-8s | ✅ Context-aware audio | Newer/faster Veo 3, last-frame support |228| **Veo-3.1** | `google/veo-3.1` | higher | 4-8s | ✅ Context-aware audio | Highest fidelity successor to Veo 3 |229| **Grok Video** | `xai/grok-imagine-video` | $0.05/sec | 1-15s | ✅ Auto (music, SFX, lip-sync) | Longer videos, best audio |230| **Kling v3** | `kwaivgi/kling-v3-video` | $0.22/sec | 3-15s | ✅ Native | Cinematic quality, 1080p, multi-shot |231| **Kling v3 Omni** | `kwaivgi/kling-v3-omni-video` | varies | 3-15s | ✅ Native | Multi-modal: text, ref image, editing |232| **Sora-2** | `openai/sora-2` | varies | flexible | ✅ Synced | Home-video realism, flexible prompting |233| **WAN 2.5 fast** | `wan-video/wan-2.5-t2v-fast` | low | 5-10s | ❌ | Open-source, fast, cost-effective |234235### Duration Constraints236237| Model | Min | Max | Notes |238|-------|-----|-----|-------|239| Veo-3 | 4s | 8s | **Only accepts 4, 6, or 8** — other values rejected |240| Grok Video | 1s | 15s | Flexible, any integer |241| Kling v3 | 3s | 15s | Modes: `standard` (720p), `pro` (1080p) |242243### Video Generation Pattern244245Typical workflow: generate a still image first, then animate it:246247```javascript248// Step 1: Generate still image249const image = await replicate.run("google/nano-banana-pro", {250 input: { prompt: "Person smiling at camera", image_input: refs }251});252253// Step 2: Animate to video254const video = await replicate.run("google/veo-3", {255 input: {256 prompt: "Head turns slowly, smile widens, warm natural lighting",257 image: imageUrl,258 duration: 6259 }260});261```262263---264265## Cloud TTS Models (Replicate)266267For content creation (audiobooks, narration, voice cloning), Replicate offers paid TTS models that complement the free Edge TTS in the extension.268269| Model | Replicate ID | Cost | Voice Cloning | Languages | Best For |270|-------|-------------|------|---------------|-----------|----------|271| **Speech Turbo** | `minimax/speech-2.8-turbo` | $0.06/1k tokens | ❌ | 40+ | Fast, expressive, many voices |272| **Chatterbox Turbo** | `resemble-ai/chatterbox-turbo` | $0.025/1k chars | ✅ (5s sample) | English | Voice cloning, natural pauses |273| **Qwen TTS** | `qwen/qwen3-tts` | $0.02/1k chars | ✅ | 10 | Voice design from description |274275### Voice Presets276277**Speech Turbo**: `Wise_Woman`, `Deep_Voice_Man`, `Casual_Guy`, `Lively_Girl`, `Young_Knight`, `Abbess`, + 6 more278**Chatterbox**: `Andy`, `Luna`, `Ember`, `Aurora`, `Cliff`, `Josh`, `William`, `Orion`, `Ken`279**Qwen TTS**: `Aiden`, `Dylan`, `Eric`, `Serena`, `Vivian`, + 4 more280281### Emotion Control (Speech Turbo)282283Supported emotions: `auto`, `happy`, `sad`, `angry`, `fearful`, `disgusted`, `surprised`284285### Voice Cloning (Chatterbox / Qwen)286287Provide a 5+ second audio sample to clone a voice:288289```javascript290const output = await replicate.run("resemble-ai/chatterbox-turbo", {291 input: {292 text: "Content to speak in the cloned voice",293 audio_prompt: referenceAudioDataURI // 5+ seconds WAV/MP3294 }295});296```297298### Voice Design (Qwen TTS)299300Create a voice from a natural language description:301302```javascript303const output = await replicate.run("qwen/qwen3-tts", {304 input: {305 text: "Content to speak",306 tts_mode: "voice_design",307 voice_description: "A warm, friendly female voice with a slight British accent"308 }309});310```311312### When to Use Cloud TTS vs Edge TTS313314| Scenario | Recommended | Why |315|----------|-------------|-----|316| Read document in VS Code | Edge TTS (extension) | Free, instant, integrated |317| Create audiobook narration | Replicate TTS | Higher quality, voice cloning |318| Generate voice for video | Replicate TTS | Emotion control, design voices |319| Multi-language content creation | Either | Edge has 32 languages; Speech Turbo has 40+ |320321---322323## Synapses324325See [synapses.json](synapses.json) for connections.