---
name: wiozen-voice
description: Remotion ya da başka bir kodla video projesinde sahne metninden Wiozen Voice ile seslendirme üretir, ses dosyasını ve cümle zamanlarını projeye koyar, kompozisyon süresini ve altyazıyı bu zamanlara göre kurar. Kullanıcı seslendirme, dış ses, voiceover ya da "sahneyi sese göre zamanla" dediğinde kullan.
---

# Wiozen Voice ile seslendirme

Ön koşul: `wiozen-voice` MCP sunucusu bağlı:
claude mcp add --transport http wiozen-voice https://api.wiozen.com/mcp --header "Authorization: Bearer ${WIOZEN_API_KEY}"

1. Sahne metnini kullanıcıdan ya da projedeki senaryo dosyasından al. Metni değiştirme; yazım düzeltmesi gerekiyorsa önce sor.
2. Ses seçilmemişse `list_voices` ile metnin dilinde ana dili olan sesleri listele, kullanıcıya bir tane seçtir.
3. `estimate` çağır; ücreti ve süreyi tek satırda söyle. Ücret 1 doları geçiyorsa onay iste.
4. `synthesize` çağır: `timings: "sentence"`, `idempotency_key` = sahne adı + metnin kısa özeti. Uzun metinde `get_job` ile bitmesini bekle.
5. Dönen iki dosyayı projeye indir. Remotion'da: `public/voice/<sahne>.mp3` ve `src/voice/<sahne>.timings.json`.
6. Kompozisyonu kur: `durationInFrames = Math.ceil(timings.durationMs / 1000 * fps)`; sesi `staticFile("voice/<sahne>.mp3")` ile ekle; `timings.captions` dizisi `@remotion/captions` `Caption[]` biçimindedir, altyazı bileşenine ya da `createTikTokStyleCaptions` işlevine doğrudan ver; sahne geçişlerini `timings.parts` sınırlarına koy.
7. Metin sonradan değişirse yalnız değişen sahneyi yeniden seslendir; yeni metin için yeni `idempotency_key` kullan (aynı anahtar eski sonucu döndürür).

Yapma: ses klonlama ya da gerçek bir kişiyi taklit isteme (desteklenmiyor, kurallara aykırı); dosya adreslerini paylaşma (24 saat boyunca bağlantıyı bilen indirebilir); API anahtarını dosyaya yazma (ortam değişkeninde kalsın).
