Transkriba — Russian audio transcription

Переводит аудио или видео по ссылке в текст с таймкодами. Передайте diarize=true, если нужно разделение по спикерам. Понимает публичные записи YouTube, VK Видео, Rutube, Дзен, OK, Castbox и SoundCloud. Возвращает job_id сразу: результат забирается инструментом get_transcript. Списывает минуты с баланса по факту длительности записи.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Ссылка на запись"
    },
    "language": {
      "type": "string",
      "description": "Код языка, например ru или en. Без него определяется сам."
    },
    "diarize": {
      "type": "boolean",
      "description": "Разделить запись по спикерам. По умолчанию false."
    }
  },
  "required": [
    "url"
  ]
}

Путь для локального файла, у которого нет публичной ссылки. Передайте file_name и точный size_bytes. Возвращает upload_url, s3_key и обязательный content_type. Загрузите файл запросом PUT, передав Content-Type и Content-Length в точности из ответа (например, curl -X PUT -H 'Content-Type: application/octet-stream' -H 'Content-Length: 1048576' --data-binary @file.ogg <upload_url>), после чего передайте s3_key и file_name в transcribe_file. Ссылка живёт 30 минут; один файл может занимать не более 256 МБ.

{
  "type": "object",
  "properties": {
    "file_name": {
      "type": "string",
      "description": "Имя файла с расширением, например voice.ogg"
    },
    "content_type": {
      "type": "string",
      "description": "MIME-тип файла. По умолчанию application/octet-stream."
    },
    "size_bytes": {
      "type": "number",
      "description": "Точный размер файла в байтах, от 1 до 268435456."
    }
  },
  "required": [
    "file_name",
    "size_bytes"
  ]
}

Переводит в текст файл, загруженный по ссылке из create_upload. Возвращает job_id сразу: результат забирается инструментом get_transcript. Списывает минуты с баланса по факту длительности записи.

{
  "type": "object",
  "properties": {
    "s3_key": {
      "type": "string",
      "description": "Ключ из ответа create_upload"
    },
    "language": {
      "type": "string",
      "description": "Код языка, например ru или en. Без него определяется сам."
    },
    "file_name": {
      "type": "string",
      "description": "Человеческое имя записи для списка расшифровок"
    },
    "diarize": {
      "type": "boolean",
      "description": "Разделить запись по спикерам. По умолчанию false."
    }
  },
  "required": [
    "s3_key",
    "file_name"
  ]
}

Возвращает состояние задачи по job_id, а когда она готова — текст с таймкодами и метками спикеров, если при запуске было передано diarize=true. Пока идёт расшифровка, отвечает status=processing: вызывайте повторно с паузой в несколько секунд. Время зависит от длины записи, очереди и запуска обработчика.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Идентификатор из transcribe_url"
    },
    "format": {
      "type": "string",
      "enum": [
        "text",
        "srt",
        "vtt",
        "json"
      ],
      "description": "Формат ответа. По умолчанию text — реплики с таймкодами."
    }
  },
  "required": [
    "job_id"
  ]
}

Перечисляет последние расшифровки учётной записи: id, имя файла, длительность и состояние. Полезно, чтобы найти job_id вчерашней записи, не спрашивая человека.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Сколько записей вернуть, до 50"
    }
  }
}

Ищет фразу по текстам последних 200 готовых расшифровок и возвращает совпадения с таймкодом и именем спикера. Так можно найти, где именно на трёхчасовом созвоне обсуждали сроки, не перечитывая всё.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Что искать"
    },
    "limit": {
      "type": "number",
      "description": "Сколько совпадений вернуть, до 50"
    }
  },
  "required": [
    "query"
  ]
}

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

{
  "type": "object",
  "properties": {}
}