Создать батч

POST

https://corp.textom.app/api/v1/batch

Пакетно создаёт задачи по списку файлов. Каждый файл может использовать свой источник (ваша ссылка или наше хранилище).

Тело запроса

Параметр	Тип	Описание
name	string	Название батча (для удобства).
filesrequired	array	Список файлов.
files.filenamerequired	string
files.sourcerequired	object	Источник файла. Либо ссылка на ваш файл (BYOS), либо ID файла, загруженного в наше хранилище через /files/upload-url.
files.source.typerequired	enum urlfile_id	url — скачать по ссылке; file_id — файл уже в нашем S3.
files.source.url	string	Обязательно при type=url. HTTPS-ссылка на аудио/видео файл.
files.source.file_id	uuid	Обязательно при type=file_id. ID из ответа /files/upload-url.
settingsrequired	object	Общие настройки распознавания для всех файлов.
settings.model_sizedefault: turbo	enum turbomediumlarge-v2
settings.languagedefault: auto	string
settings.speakerdefault: none	enum nonediarize
settings.noisedefault: none	enum nonedenoise

Ответы

201Батч создан.

batch_id uuid

status string

total_tasks integer

created integer

failed integer

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

curl \
  -X POST \
  -H "X-API-Key: co_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "январские записи",
    "files": [
      { "filename": "a.mp4", "source": { "type": "url", "url": "https://..." } },
      { "filename": "b.mp4", "source": { "type": "file_id", "file_id": "..." } }
    ],
    "settings": { "model_size": "turbo", "language": "ru" }
  }' \
  "https://corp.textom.app/api/v1/batch"

Try it

API-ключ

Body

URL/api/v1/batch