API транскрибации и конспектов

1. В боте отправьте /apikey — получите ключ вида cvk_…. Баланс минут общий с ботом и сайтом; первые 9 минут — бесплатно.
2. Создайте заказ: POST https://conspectvsego.ru/api/v1/order с заголовком X-Api-Key.
3. Опрашивайте GET /api/v1/status/{job_id} раз в 10–20 секунд, пока status не станет done.
4. Скачайте файлы по ссылкам из ответа (хранятся 4 часа).

1. Создать заказ — POST /api/v1/order

JSON со ссылкой (YouTube, Rutube, VK, прямая ссылка на файл или статья):

curl -X POST https://conspectvsego.ru/api/v1/order \
  -H "X-Api-Key: cvk_ВАШ_КЛЮЧ" -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=XXXX", "title": "Лекция 3", "tts": true}'

Или multipart с файлом (аудио, видео, PDF/DOCX/EPUB/FB2/TXT — до 2 ГБ):

curl -X POST https://conspectvsego.ru/api/v1/order \
  -H "X-Api-Key: cvk_ВАШ_КЛЮЧ" \
  -F file=@lecture.mp4 -F title="Лекция 3" -F tts=0

Ответ: {"job_id": "…", "status": "processing", "status_url": "https://conspectvsego.ru/api/v1/status/…"}

2. Статус и результат — GET /api/v1/status/{job_id}

curl https://conspectvsego.ru/api/v1/status/JOB_ID -H "X-Api-Key: cvk_ВАШ_КЛЮЧ"

{"status": "done", "minutes": 47.3, "expires_in": 3540,
 "conspect": "## Суть\n…конспект в Markdown с таймкодами [MM:SS]…",
 "pdf": "https://conspectvsego.ru/api/web/file/JOB_ID/conspect.pdf",
 "mp3": "https://conspectvsego.ru/api/web/file/JOB_ID/conspect.mp3",
 "srt": "https://conspectvsego.ru/api/web/file/JOB_ID/transcript.srt",
 "txt": "https://conspectvsego.ru/api/web/file/JOB_ID/transcript.txt"}

status: processing → done | error (поле error с причиной). srt/txt есть только для аудио и видео; mp3 — если tts не выключен.

3. Баланс — GET /api/v1/me

{"platform": "tg", "balance_min": 287.5, "trial_used": true, "free_trial_minutes": 9}

Коды ошибок

• Цена — как в боте: 1 ₽/мин пакетом «300 минут» (299 ₽), 0,33 ₽/мин «Студент» (199 ₽/мес, 600 мин), 0,25 ₽/мин «Про» (499 ₽/мес, 2000 мин). У конкурентов API транскрибации стоит 5–8 ₽/мин.
• Пробник — первая обработка до 9 минут бесплатно, действует и через API.
• Лимиты — файл до 8 ГБ, запись до 10 часов; длинные записи режутся автоматически. Результаты хранятся 4 часа.
• Книги и статьи — тарифицируются эквивалентом минут, как на сайте.

Сколько стоит API?

Столько же, сколько бот и сайт: минуты списываются с общего баланса — 1 ₽/мин пакетом или 0,25–0,33 ₽/мин по подписке. Бесплатный пробник до 9 минут действует и через API.

Как получить ключ API?

Отправьте команду /apikey в Telegram- или MAX-боте — ключ приходит сразу. Перевыпуск: /apikey new (старый ключ перестаёт работать).

Нужны объёмы больше или распознавание голосов?

Для корпоративных объёмов, диаризации (кто говорит) и протоколов встреч и судебных заседаний напишите на hello@conspectvsego.ru.