Klip Transkripti

GET/v1/twitch/clip/transcript1 kredi

Bir klipteki konuşmanın transkriptini döndürür. Twitch kliplerinde altyazı bulunmadığından metin, `use_ai_as_fallback=true` ile izin verdiğinizde yapay zekâ destekli konuşmadan metne dönüştürmeyle üretilir.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Klibin URL'si: `https://www.twitch.tv/<kanal>/clip/<slug>` ya da `https://clips.twitch.tv/<slug>`.
use_ai_as_fallbackisteğe bağlı	boolean	Klibin sesini yapay zekâyla yazıya dökmek için `true` verin. Verilmezse yanıtta `transcript: null` döner ve ücret alınmaz.Varsayılan: `false`
allow_long_transcriptionisteğe bağlı	boolean	120 saniyeden uzun kliplerin yapay zekâyla yazıya dökülmesine izin vermek için `true` verin; başlayan her dakika için 10 kredi alınır.Varsayılan: `false`

02Fiyatlandırma

`use_ai_as_fallback=true` olmadan: 0 kredi (transkript dönmez). Verildiğinde: 120 saniyeye kadar bir klip için 1 kredi; `allow_long_transcription=true` ile daha uzun klipler başlayan her dakika için 10 kredi. Konuşma içermeyen bir klip 0 kredi.

03İstek

curl "https://api.scrapesocial.ai/v1/twitch/clip/transcript?url=https%3A%2F%2Fclips.twitch.tv%2FUgliestCreativeWolfChefFrank-PJRt7Wmz_gVzJhk6&use_ai_as_fallback=true" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Yanıtlar

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

GET /v1/twitch/clip/transcript?url=https%3A%2F%2Fclips.twitch.tv%2FUgliestCreativeWolfChefFrank-PJRt7Wmz_gVzJhk6&use_ai_as_fallback=true

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "300458633",
  "url": "https://www.twitch.tv/shroud/clip/UgliestCreativeWolfChefFrank-PJRt7Wmz_gVzJhk6",
  "transcript": "Come, come, come, come, come, come. Follow my voice, come. Guys? This way. Guys! Guys! Guys! Oh, no.",
  "transcript_source": "ai",
  "duration_seconds": 41.28,
  "duration_minutes": 0.69
}

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 `id`, `url`, `transcript` ve `transcript_source` (`ai`; transkript yoksa null) bulunur; yapay zekâ transkriptinde ayrıca `duration_seconds` ve `duration_minutes` yer alır. `allow_long_transcription=true` olmadan 120 saniyeden uzun bir klip ücretsiz bir 400 hatası verir. Bulunamayan bir klip ücretsiz bir 404 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.