QuillAIQuillAIDocs
Войти →

QuillAI API

QuillAI — это API для транскрибации аудио и видео: отправьте ссылку на YouTube или Instagram, прямой URL файла или загрузите свой, и получите текст, сегменты с разметкой по спикерам, структурированное саммари и субтитры.

Транскрибация выполняется асинхронно. Вы отправляете POST-запрос, сразу получаете идентификатор задачи и дальше либо опрашиваете эндпоинт транскрипции, либо подписываетесь на webhook, чтобы узнать о готовом результате.

Базовый URL

text
https://api.quillhub.ai

На время беты API также доступен по адресу https://api-production-08d8.up.railway.app. Оба хоста обслуживают одни и те же эндпоинты; в продакшене используйте канонический URL.

Аутентификация

Каждый запрос требует bearer-токен в заголовке Authorization. Ключи выпускаются в дашборде и начинаются с qai_live_. Подробнее об управлении ключами — в разделе Аутентификация.

bash
curl https://api.quillhub.ai/v1/me \
  -H "Authorization: Bearer qai_live_..."

Быстрый пример

Создание транскрипции по ссылке на YouTube:

create-transcription.shbash
curl -X POST https://api.quillhub.ai/v1/transcriptions \
  -H "Authorization: Bearer qai_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "speaker_recognition": true,
    "structure": true
  }'

API отвечает 202 Accepted и возвращает ресурс задачи:

json
{
  "id": "trs_abc123",
  "status": "queued",
  "progress": 0,
  "source": {
    "type": "youtube",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  },
  "options": {
    "speaker_recognition": true,
    "structure": true
  },
  "created_at": "2026-04-23T10:15:00Z"
}

Разделы

  • Быстрый старт — Первая транскрипция за пять минут.
  • Аутентификация — Создание, ротация и отзыв API-ключей.
  • YouTube и Instagram — Транскрибация ссылок YouTube и Instagram.
  • Вебхуки — Получение событий готовности без опроса API.
  • Ошибки — Коды ошибок, семантика повторов и лимиты.
  • MCP-сервер — Подключите QuillAI к Claude Desktop, Cursor, Antigravity и другим AI-ассистентам через MCP.
  • API Reference — Полный OpenAPI-справочник по всем эндпоинтам и полям.

Тарификация

Биллинг ведётся в баллах, а не в минутах. Каждая завершённая транскрипция возвращает поле points_spent, а остаток баланса доступен через GET /v1/me. Актуальные тарифы и пополнение — на странице тарифов.