Felo APIs

YouTube Subtitling API

İsteğe bağlı dil ve zaman damgası parametreleriyle YouTube altyazılarını alın.

GET/v2/youtube/subtitling

Kimlik doğrulama

Bearer API key

İçerik türü

Gerekli değil

Hız sınırı notları

Endpoint bazında sınırlar geçerli olabilir.

Web Fetch API

YouTube Subtitling API, bir YouTube videosu için yapılandırılmış altyazı verilerini getirir. Ajanlar, içerik analizi araçları, eğitim ürünleri, arama dizinleri ve video içeriğine metin olarak ihtiyaç duyan iş akışları için tasarlanmıştır.

Endpoint

GET https://openapi.felo.ai/v2/youtube/subtitling

Kimlik Doğrulama

API anahtarınızı Authorization başlığında gönderin:

Authorization: Bearer YOUR_API_KEY

API anahtarları oluşturma ve yönetme ayrıntıları için Kimlik Doğrulama Kılavuzu sayfasına bakın.

AI Ajanlarıyla Kullanım

Bir Ajana YouTube altyazılama ve mevcut diğer tüm Felo Skill'lerini kazandırmak için eksiksiz felo-ai paketini yükleyin. Yükleyici, SKILL.md içeren her paket dizinini dinamik olarak keşfeder; bu nedenle sabit bir Skill listesine bağlı değildir. Keşfedilen tüm Skill'leri Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills veya Hermes Agent ~/.hermes/skills dizinlerine yükleyin. Platforma özgü API anahtarı yapılandırması ve doğrulaması için manuel AI Ajanı kurulum kılavuzunu kullanın.

İstek

Sorgu Parametreleri

Parametre	Tür	Gerekli	Varsayılan	Açıklama
`video_code`	string	Evet	-	YouTube video kimliği; örneğin `dQw4w9WgXcQ`.
`language`	string	Hayır	-	Altyazı dil kodu; örneğin `en` veya `zh-CN`. Atlanırsa alt akış hizmeti mevcut dili seçer.
`with_time`	boolean	Hayır	`false`	Her altyazı öğesi için zaman damgası alanlarının (`start` ve `duration`) dahil edilip edilmeyeceği.

Hizmet dahili olarak tam başlık ve transkript modunu kullanır. Bir işlev türü veya mod parametresi iletmeniz gerekmez.

Yanıt

Başarılı Yanıt

{
  "status": "ok",
  "message": null,
  "data": {
    "title": "Example Video Title",
    "contents": [
      {
        "start": 0.32,
        "duration": 14.26,
        "text": "Subtitle text"
      }
    ]
  }
}

Yanıt Alanları

Alan	Tür	Açıklama
`status`	string	Yanıt durumu. Başarılı bir istek için genellikle `ok`.
`message`	string or null	Ek mesaj. Başarılı istekler için genellikle `null`.
`data.title`	string	YouTube video başlığı.
`data.contents`	array	Altyazı öğelerinin listesi.
`data.contents[].start`	number	Saniye cinsinden altyazı başlangıç zamanı. Zaman damgası verileri mevcut olduğunda, özellikle `with_time=true` iken döndürülür.
`data.contents[].duration`	number	Saniye cinsinden altyazı süresi. Zaman damgası verileri mevcut olduğunda, özellikle `with_time=true` iken döndürülür.
`data.contents[].text`	string	Altyazı metin içeriği.

Hata Yanıtları

HTTP Durumu	Hata Kodu	Açıklama	Önerilen Eylem
400	`YOUTUBE_SUBTITLING_FAILED`	İstek doğrulaması başarısız oldu, video mevcut değil, altyazılar kullanılamıyor veya alt akış hizmeti istemci tarafı bir hata döndürdü.	`video_code`, altyazı kullanılabilirliği ve `language` değerlerini kontrol edin.
401	`UNAUTHORIZED`	API anahtarı eksik, geçersiz veya iptal edilmiş.	API anahtarınızı ve authorization başlığını doğrulayın.
500	`YOUTUBE_SUBTITLING_FAILED`	Dahili hizmet hatası.	İsteği yeniden deneyin. Sorun devam ederse destek ekibiyle iletişime geçin.
502	`YOUTUBE_SUBTITLING_FAILED`	Alt akış YouTube altyazı hizmeti başarısız oldu veya kullanılamıyordu.	Daha sonra yeniden deneyin.

Örnekler

Temel İstek

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

Belirli bir Dil İsteme

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=en" \
  -H "Authorization: Bearer YOUR_API_KEY"

Zaman Damgalarını Dahil Etme

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Belirli bir Dil için Zaman Damgalarını Dahil Etme

curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ&language=zh-CN&with_time=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kullanım Senaryoları

Bir ajanın soruları yanıtlamadan önce bir YouTube videosunu anlamasını sağlayın.
Video içerikleri için aranabilir bir metin dizini oluşturun.
Özetleme veya çeviri iş akışları için kaynak metin hazırlayın.
Oluşturulan notları veya alıntıları zaman damgalarıyla eşleştirin.
Video dosyasını indirmeden eğitim veya araştırma videolarını analiz edin.

Notlar

Bu API video veya ses indirmez.
Mevcut altyazıları döndürür. Altyazı verisi olmayan videolar için altyazı oluşturmaz.
Bazı videolarda altyazı olmayabilir veya istenen dil sunulmayabilir.
language atlanırsa, altyazı dili seçimi alt akış kullanılabilirliğine bağlıdır.