x/
post-transcript

Расшифровывайте речь в видео X по URL их постов: произнесенные слова возвращаются простым текстом вместе с длительностью каждого видео в секундах, несколько постов в одном запросе.

Twitter Video Transcript API

URL поста на входе
Расшифровка простым текстом
Длительность в секундах
0,7 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Twitter Video Transcript

Видео в X (бывший Twitter) содержат в звуковой дорожке интервью, анонсы, демонстрации продуктов и комментарии, а расшифровка превращает эту речь в простой текст вместе с длительностью ролика в секундах. Записанную речь можно точно цитировать, кратко пересказывать, переводить и искать по ней теми же методами анализа ключевых слов и тем, что применяются к текстовым постам.

Возможности Twitter Video Transcript API

  • Посты с видео по URLПередайте одну или несколько ссылок вида x.com/{username}/status/{post_id} на твиты с видео, и каждое видео вернет одну строку с id и url своего поста.
  • Речь сплошным простым текстомtext содержит произнесенные в видео слова одним блоком простого текста, format равно «text», а язык расшифровки совпадает с языком говорящего.
  • Длительность видео вместе с расшифровкойduration_seconds показывает продолжительность видео — это удобно для сортировки роликов по длине и для оценки того, насколько плотно в видео звучит речь.

Параметры Twitter Video Transcript API

ПараметрыОбязательныйОписание
urlsОбязательныйОдин или несколько URL постов X вида /{username}/status/{post_id}, каждый из которых указывает на пост с видео.

Как использовать Twitter Video Transcript API

Отправьте URL постов с видео и получите по одной расшифровке на каждое видео.

  1. Отправьте {"urls": ["https://x.com/NASA/status/2119833829389041896"]} методом POST на /v1/x/post-transcript.
  2. Опрашивайте GET /v1/tasks/{task_id}; расшифровки готовы, когда status становится succeeded.
  3. Читайте каждую расшифровку из results.items, а если has_more равно true, получайте остальное с помощью results.next_cursor.
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/NASA/status/2119833829389041896"]}'

# Videos up to 2 minutes cost 0.7 credits; longer ones cost 4 credits per started minute.

Сценарии использования Twitter Video Transcript API

  • Цитирование сказанного в ролике: Копируйте точные фразы из text и указывайте url поста, чтобы цитату из интервью или пресс-ролика можно было сверить с источником.
  • Краткий пересказ и перевод видеопостов: Передавайте text в модель суммаризации или перевода, чтобы превращать длинные видеопосты в короткие заметки или переводить их на другие языки.
  • Поиск по речи во множестве видео: Индексируйте расшифровки видеопостов автора или бренда, чтобы находить все ролики, где упоминается продукт, человек или тема.
  • Публикация текстовой версии видео: Размещайте text под видео в статьях, рассылках или справочных материалах, чтобы читатели могли следить за ним без звука.

Практические советы по Twitter Video Transcript API

  • Закладывайте бюджет на длинные записи отдельно: видео длительностью до 2 минут стоит 0,7 кредита, а 10-минутная запись — 40 кредитов, поскольку оплачивается каждая начатая минута полной длительности.
  • Определяйте язык text, прежде чем отправлять его на перевод: каждая расшифровка написана на языке, на котором говорят в видео.
  • Если вы не уверены, в каких постах есть видео, отправляйте смешанные списки URL: посты с видео вернут расшифровки, остальные ничего не стоят, а список только из текстовых постов или постов с изображениями завершится ошибкой с полным возвратом кредитов.

Помимо Twitter Video Transcript API, используйте эти API, когда нужен другой тип публичных данных X.

  • Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
  • X Post Replies API — Собирайте публичные ответы по URL постов X с выбором порядка: текст ответа, авторы, видимая вовлеченность, медиа и контекст родительского поста.
  • Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.
  • Twitter Media Scraper API — Собирайте посты аккаунта с фото, видео и GIF вместе с медиафайлами в максимальном качестве.

Другие платформы

Объединяйте данные X с публичными данными других поддерживаемых соцсетей.

Twitter Video Transcript API — FAQ

Twitter Video Transcript API — это программный интерфейс для преобразования речи из видео X в текст по URL постов, которые содержат эти видео. Для каждого видео он возвращает расшифровку простым текстом и длительность видео в секундах.

Скопируйте ссылку на пост, добавьте ее в urls (он принимает несколько ссылок в одном запросе) и прочитайте расшифровку из text после успешного завершения задачи.

Нет. Для каждого видео возвращается одна расшифровка простым текстом с format «text» и общей длительностью duration_seconds; тайминги по строкам отсутствуют.

Видео длительностью до 2 минут стоит 0,7 кредита. Более длинные видео стоят 4 кредита за каждую начатую минуту полной длительности, поэтому 3-минутное видео стоит 12 кредитов.

Расшифровка пишется на языке, на котором говорят в видео. В результате нет метки языка, поэтому, если она нужна вашему рабочему процессу, определяйте язык по text.

Посты без видео не возвращают строк и не оплачиваются. Если ни в одном из переданных постов нет видео, задача завершается ошибкой, а кредиты возвращаются полностью.