Metin-Video API: Geliştirici için Tam Rehber
2026'da video üretimi kullanılabilirlik eşiğini geçti. Bir senaryo gönderiyorsunuz; yayımlanabilir bir video alıyorsunuz.
Endpoint Özeti
POST https://api.speekoapp.com/v1/videoİstek Parametreleri
| Parametre | Tip | Gerekli | Açıklama |
|---|---|---|---|
| text | string | Evet | Anlatım senaryosu |
| voice | string | Evet | Ses ID |
| resolution | string | Hayır | 720p, 1080p, 4K (varsayılan: 1080p) |
| aspect_ratio | string | Hayır | 16:9, 9:16, 1:1 (varsayılan: 16:9) |
| style | string | Hayır | stock, animated, minimal (varsayılan: stock) |
| background_music | boolean | Hayır | Otomatik telifsiz müzik (varsayılan: false) |
| subtitles | boolean | Hayır | Altyazıları göm (varsayılan: true) |
| webhook_url | string | Hayır | Video hazır olduğunda callback |
Platforma Göre En-Boy Oranı
- YouTube uzun-form — 16:9, 1080p veya 4K
- YouTube Shorts / TikTok / Reels — 9:16, 1080×1920
- Instagram feed — 1:1 veya 4:5
- LinkedIn — 1:1 veya 16:9
Asenkron İşleme
Video üretimi 30-120 saniye sürer. Üretim için her zaman webhook kullanın:
const response = await fetch('https://api.speekoapp.com/v1/video', {
method: 'POST',
headers: {
'Authorization': 'Bearer ANAHTARINIZ',
'Content-Type': 'application/json'
},
body: JSON.stringify({
text: 'Kanalımıza hoş geldiniz. Bugün AI konuşuyoruz.',
voice: 'tr_male_emre',
resolution: '1080p',
aspect_ratio: '16:9',
webhook_url: 'https://sunucunuz.com/video-hazir'
})
});
const { job_id } = await response.json();Webhook Payload
{
"job_id": "vid_abc123",
"status": "completed",
"video_url": "https://cdn.speekoapp.com/videos/abc123.mp4",
"duration_seconds": 42,
"cost_credits": 120
}Fiyatlandırma
Video çıktının saniyesi başına fiyatlanır: 1080p için $0.05/sn. 60 saniyelik video $3 tutar.
En İyi Uygulamalar
- 2 dakika altında senaryolar — Daha uzun videolar zaten izleyici kaybediyor
- Doğal ritim — Nefes boşluğunu üreticinin yönetmesine izin verin
- Güçlü açılış — İlk 3 saniye izleyicilerin kalıp kalmayacağına karar verir
- En-boy oranlarını test edin — 16:9 kaynak 9:16'ya kırpıldığında nadiren çalışır