İçeriğe geç
ENPanel

Video Transkripti

GET/v1/tiktok/video/transcript1 kredi

Bir TikTok videosunun transkriptini döndürür: altyazısı varsa WebVTT olarak, izin verirseniz altyazısı olmayan videolarda yapay zekâ ile sesten metne dönüştürülmüş düz metin olarak.

01Sorgu parametreleri

AdTürAçıklama
urlzorunlustringVideonun URL'si (`tiktok.com/@kullanici/video/<id>` veya kısa paylaşım bağlantısı).
languageisteğe bağlıstringDöndürülecek altyazının iki harfli dil kodu (ör. `en`). Verilmezse otomatik oluşturulan altyazı, o da yoksa ilk mevcut altyazı seçilir.
use_ai_as_fallbackisteğe bağlıbooleanVideonun altyazısı yoksa sesini yapay zekâ ile yazıya döker.Varsayılan: false
allow_long_transcriptionisteğe bağlıbooleanYapay zekâ yedeğinin 120 saniyeden uzun videolarda da çalışmasına izin verir; başlayan her dakika 10 kredidir.Varsayılan: false

02Fiyatlandırma

Altyazı döndüğünde 1 kredi. Altyazı yoksa ve yapay zekâ yedeği kullanılmadıysa 0 kredi. Yapay zekâ yedeği: 120 saniyeye kadar videolar 1 kredi; daha uzun videolar `allow_long_transcription=true` gerektirir ve başlayan her dakika için 10 kredi tutar. Konuşma bulunamazsa 0 kredi.

03İstek

curl "https://api.scrapesocial.ai/v1/tiktok/video/transcript?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7683195368279985438" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/tiktok/video/transcript?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7683195368279985438

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "7683195368279985438",
  "url": "https://www.tiktok.com/@tiktok/video/7683195368279985438",
  "transcript": "WEBVTT\n\n\n00:00:00.100 --> 00:00:00.820\nWait,\n\n00:00:00.821 --> 00:00:06.501\nthere's basically an entire hard techno rave hiding inside TikTok Live?\n\n00:00:06.502 --> 00:00:08.621\nHi, my name is Palina LA Diva.\n\n00:00:08.622 --> 00:00:12.021\nI'm a hard techno music producer and DJ.\n\n00:00:12.022 --> 00:00:15.661\nYou might have seen me playing eggs in Tokyo\n\n00:00:15.662 --> 00:00:17.201\nall the way…"
}

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ıt `id`, `url` ve `transcript` alanlarından oluşur: altyazıdan gelen bir WebVTT metni, yapay zekâ yedeğinden gelen düz metin veya hiçbir şey yoksa null. Yapay zekâ yedeği gerektiğinde, `allow_long_transcription=true` verilmemiş 120 saniyeden uzun bir video ücretsiz 400 döner. Fotoğraf gönderilerinde yazıya dökülecek ses yoktur (404). Bilinmeyen bir video ücretsiz 404 döner.

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.