Videos

Расшифровать ролик YouTube по ссылке

Дословная расшифровка с таймкодами (exact) или пересказ (fast) публичного ролика YouTube. Ролик по ссылке смотрит модель google/gemini-3.8-flash, скачивать видео не нужно. Не путать с /v1/videos — там генерация.

До запроса к модели ролик проверяется: удалённый, приватный, открытый только по ссылке, прямой эфир и ролик длиннее 4 часов отклоняются без списания.

Оплата по токенам, как у запроса к модели: usage.cost — сумма в копейках. Если ответ в режиме exact упирается в лимит длины, Hubris сам запрашивает продолжение и склеивает куски — до 5 запросов к модели (usage.requests). Стрима нет, ответ приходит целиком.

Ошибки самого запроса к модели (402, 429, 5xx) приходят в том же виде, что у /v1/chat/completions.

post/v1/video/transcriptions

Request

  • Base URL: https://api.hubris.pw
  • URL: https://api.hubris.pw/v1/video/transcriptions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.hubris.pw/oauth/authorize, token URL https://api.hubris.pw/oauth/token, scopes: chat:write)

Request body

urlstring required

Ссылка на ролик YouTube: youtube.com/watch?v=…, youtu.be/…, youtube.com/shorts/…, youtube.com/live/….

mode'exact' | 'fast'

exact — дословная расшифровка, каждая реплика с новой строки и таймкодом [HH:MM:SS]. fast — пересказ и ключевые мысли с таймкодами: быстрее и дешевле на длинном ролике, таймкоды приблизительные.

diarizeboolean

Только для exact: помечать реплики говорящими («Говорящий 1:» или имя, если оно звучит в ролике).

Example request

{
  "url": "https://youtu.be/ITL6WqcV6sE"
}

Response

Расшифровка или пересказ.

idstring required
object'video.transcription' required
createdinteger required

Unix-секунды.

modelstring required

Модель, которая смотрела ролик.

mode'exact' | 'fast' required
diarizeboolean required

В режиме fast всегда false.

textstring required

Расшифровка или пересказ.

truncatedboolean required

true — текст оборвался по лимиту длины ответа даже после продолжений, или продолжение не удалось и отдано собранное.

Example response

{
  "id": "vtr-3f9c1a7b2d4e5f60a1b2c3d4"
}

Changes

No recorded changes to this operation across all 1 revision of this API.