Перейти к основному содержимому

POST /start

Запуск нового заказа на транскрибацию и создание конспекта по аудио или видеоматериалам.

Запрос​

Метод: POST

URL: https://api.conspecto.ru/v1/start

Ограничения​

  • Максимальный размер загружаемого файла: 2000 Мб.

Тело запроса​

{
  "language": "string",
  "order_type": "string",
  "file": "binary",
  "num_speakers": "number"
}

Пример:

{
  "language": "ru",
  "order_type": "transcribe",
  "file": "binary_data",
  "num_speakers": 2
}

Описание параметров​

  • language (string): Язык аудиофайла в формате ISO 639-1. Например, 'ru', 'en', 'fr'.
  • order_type (string): Тип заказа. Поддерживаются только 'transcribe' и 'transcribe+format'.
  • file (binary): Аудиофайл для обработки.
  • num_speakers (number, optional): Количество спикеров для разделения. Возможные значения:
    • 0: Без разделения на спикеров (по умолчанию)
    • -1: Автоматическое определение количества спикеров
    • 2-5: Конкретное количество спикеров

Ответ​

Успешный ответ:

Статус: 200 OK

{
  "job_id": "string",
  "status": "string",
  "amount": "number",
  "remaining_balance": "number"
}

Пример:

{
  "job_id": "dj38aiksk993",
  "status": "pending",
  "amount": 10.0,
  "remaining_balance": 90.0
}

Возможные коды ответов​

  • 200: Заказ успешно запущен.
  • 400: Неверный ввод или отсутствие необходимых параметров.
  • 402: Необходима оплата.
  • 500: Внутренняя ошибка сервера.

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

curl -X POST "https://api.conspecto.ru/v1/start" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -F "language=ru" \
     -F "order_type=transcribe" \
     -F "file=@path_to_your_file" \
     -F "num_speakers=2"