Klip Transkripti

GET/v1/kick/clip/transcript1 kredi

Bir Kick klibindeki konuşmanın transkriptini döndürür. Kick kliplerinde altyazı bulunmadığından metin, `use_ai_as_fallback=true` verildiğinde yapay zekâ ile çıkarılır.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Kick klip URL'si, örneğin `https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892`; `kick.com/<kanal>?clip=<id>` biçimindeki bir bağlantı veya yalnızca `clip_…` id'si de kabul edilir.
use_ai_as_fallbackisteğe bağlı	boolean	`true` verildiğinde klibin sesi yapay zekâ ile metne dökülür. Verilmezse yanıtta `transcript: null` döner.Varsayılan: `false`
allow_long_transcriptionisteğe bağlı	boolean	`true` verildiğinde 120 saniyeden uzun kliplerin yapay zekâ ile metne dökülmesine izin verilir; başlayan her dakika için 10 kredi tutar.Varsayılan: `false`

02Fiyatlandırma

`use_ai_as_fallback` olmadan çağrı ücretsizdir (`transcript: null`). Bu parametreyle: 120 saniyeye kadar bir klip için 1 kredi; daha uzun klipler `allow_long_transcription=true` gerektirir ve başlayan her dakika için 10 kredi tutar (aksi halde ücretsiz 400 döner). Konuşma bulunamazsa çağrı ücretsizdir.

03İstek

curl "https://api.scrapesocial.ai/v1/kick/clip/transcript?url=https%3A%2F%2Fkick.com%2Fuzzyzvr%2Fclips%2Fclip_01M35J4DGERS1WE12H82WW0JBB&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/kick/clip/transcript?url=https%3A%2F%2Fkick.com%2Ffuzzyzvr%2Fclips%2Fclip_01M35J4DGERS1WE12H82WW0JBB&use_ai_as_fallback=true

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "clip_01M35J4DGERS1WE12H82WW0JBB",
  "url": "https://kick.com/uzzyzvr/clips/clip_01M35J4DGERS1WE12H82WW0JBB",
  "transcript": "Dă-mi profilul meu, 30. Mamă, dă-te-n pula mea. Mă. Vezi că pe postul politist cheamă Zaka pentru că papa a ți-a spus atunci, dar nu ai auzit. Balchistul rege nescoț și mie și lui Sebi 13.",
  "transcript_source": "ai",
  "duration_seconds": 32,
  "duration_minutes": 0.53
}

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` (klibin asıl sayfası), `transcript` ve `transcript_source` (`ai`; transkript yoksa null) alanlarını içerir; yapay zekâ transkriptinde ayrıca `duration_seconds` ve `duration_minutes` bulunur. Bilinmeyen bir klip ücretsiz 404 döner; Kick klibi olmayan bir URL ücretsiz 400 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.