Создать задачу

POST
https://corp.textom.app/api/v1/tasks

Создаёт задачу распознавания. Файл берётся из source (ваша ссылка или наше хранилище). Задача ставится в низкоприоритетную очередь и выполняется на свободных GPU.

Тело запроса

ПараметрТипОписание
sourcerequiredobjectИсточник файла. Либо ссылка на ваш файл (BYOS), либо ID файла, загруженного в наше хранилище через /files/upload-url.
source.typerequiredenum
urlfile_id
url — скачать по ссылке; file_id — файл уже в нашем S3.
source.urlstringОбязательно при type=url. HTTPS-ссылка на аудио/видео файл.
source.file_iduuidОбязательно при type=file_id. ID из ответа /files/upload-url.
task_typedefault: audioenum
audiovideoyoutuberecordpodcastlink
Тип исходного контента.
languagedefault: autostringЯзык распознавания (auto — определить).
model_sizedefault: turboenum
turbomediumlarge-v2
Модель Whisper.
speakerdefault: noneenum
nonediarize
Диаризация спикеров.
noisedefault: noneenum
nonedenoise
Шумоподавление.
webhook_urlstringURL для уведомления о завершении (опционально).

Ответы

201Задача создана и поставлена в очередь.
task_id uuid
status string
message string

Пример запроса

curl \
  -X POST \
  -H "X-API-Key: co_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": { "type": "file_id", "file_id": "..." },
    "model_size": "turbo",
    "language": "ru"
  }' \
  "https://corp.textom.app/api/v1/tasks"
Try it
/api/v1/tasks