Gönderi Transkripti
GET/v1/twitter/tweet/transcript1 kredi
Bir gönderideki videonun konuşmasını yapay zekâ destekli konuşmadan metne dönüştürme ile yazıya döker; metni videonun süresiyle birlikte döndürür.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| urlzorunlu | string | Video içeren bir gönderinin URL'si, örneğin `https://x.com/TheoVon/status/1916982720317821050`. |
| allow_long_transcriptionisteğe bağlı | boolean | Yalnızca tam olarak `true` değeri 120 saniyeden uzun videolara izin verir; başlayan her dakika 10 kredidir.Varsayılan: false |
| cache_max_ageisteğe bağlı | string | Uyumluluk için kabul edilir; her çağrı güncel veriyle yanıtlanır ve normal ücretlendirilir. Listedeki değerler dışında bir değer ücretsiz bir 400 döndürür.Kabul edilen değerler:1d3d7d14d30d |
02Fiyatlandırma
120 saniyeye kadar bir video için 1 kredi. Daha uzun videolar `allow_long_transcription=true` gerektirir ve başlayan her dakika için 10 kredidir. Videosu olmayan ya da konuşma içermeyen bir gönderi 0 kredidir.
03İstek
curl "https://api.scrapesocial.ai/v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
04Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/twitter/tweet/transcript?url=https%3A%2F%2Fx.com%2FTheoVon%2Fstatus%2F1916982720317821050
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"transcript": "Since you're kind of like a leader in innovation and technology in our world, you know, do you—how do you know that what your convictions are, how do you gauge if what your convictions are are the best for everybody, kind of? Like, how do you kind of figure that out, you know? It seems like such a challenge. I mean, look, at the end of the day, there are still a lot of options of things that peopl…",
"duration_seconds": 84.39466666666667,
"duration_minutes": 1.41
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}05Notlar
Yanıtta `transcript`, `duration_seconds` ve `duration_minutes` bulunur. Videosu olmayan bir gönderi (GIF video sayılmaz) 0 kredi karşılığında `transcript: null` ile 200 döner. `allow_long_transcription=true` olmadan 120 saniyeyi aşan bir video, videonun süresini belirten ücretsiz bir 400 döndürür.
06Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.