Тарифы и лимиты | transcript1 docs

В transcript1 вы платите за длительность записи. У тарифа есть запас минут и ограничения на запросы и одновременные задачи. Ниже — цены, правила списания и способы проверить остаток.

Тарифы

	Free	Monthly	Annual
Стоимость	$0, карта не нужна	$9 в месяц	$90 в год
Включённые минуты	60 один раз	1 000 в месяц	1 000 в месяц
Дополнительные минуты	Купить нельзя	$6 за 1 000 минут	$5 за 1 000 минут
Запросов в минуту	30	200	300
Активных задач	2	10	20

Изменить тариф или докупить минуты можно в личном кабинете на странице «Billing».

Как считаются минуты

За каждую начатую минуту записи нужен один кредит. Например, видео на 61 секунду стоит 2 минуты. Минимальное списание — 1 минута.
Цена за минуту не зависит от источника: YouTube, X, TikTok, Instagram, Facebook, Bluesky, другие поддерживаемые платформы и файлы оплачиваются одинаково. При получении субтитров измеряем длительность видео, при распознавании речи — аудио. Субтитры YouTube и X оплачиваются по тем же правилам, что TikTok и Bluesky.
Повторная обработка видео оплачивается заново, даже если transcript1 уже его расшифровывал. Чтобы получить свою недавнюю транскрибацию того же видео без повторного списания, передайте reuse_recent=true. Подробнее — в справочнике API.
Если задача завершилась с ошибкой или вы её отменили, платить не нужно. Если минуты уже списали, вернём их на баланс.

Бесплатные минуты

На новом аккаунте вы получите 60 бесплатных минут после подтверждения почты. При регистрации через Google или Microsoft начисляем их сразу. Это разовый запас: тариф Free не возобновляется. Без подтверждённой почты запрос POST /v1/transcriptions вернёт 403 email_not_verified.

Минуты по тарифу и дополнительные пакеты

На балансе есть два вида минут:

Минуты по тарифу обновляются в начале каждого расчётного периода. Остаток на следующий период не переносится. И Monthly, и Annual дают по 1 000 минут в месяц.
Дополнительные минуты можно докупить на платном тарифе. В пакете 1 000 минут, за раз можно купить от 1 до 20 пакетов. Сначала расходуются минуты по тарифу, потом дополнительные. Дополнительные не сгорают, пока действует платный тариф.

После отмены платного тарифа вы вернётесь на Free без минут по тарифу. Докупленные минуты останутся на балансе, но воспользоваться ими можно будет только после нового подключения платного тарифа. При переходе с Free на платный тариф остаток бесплатных минут переходит в дополнительные.

Как проверить баланс

Запросите GET /v1/account. Проверка баланса не расходует минуты:

curl https://api.transcript1.com/v1/account \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"

Поле	Что показывает
`minutes.remaining`	Доступный остаток: `cycle` и, при `topup_usable=true`, ещё и `topup`.
`minutes.cycle`	Остаток минут по тарифу.
`minutes.topup`	Запас дополнительных минут.
`minutes.topup_usable`	Можно ли тратить дополнительные минуты. Равно `true`, пока активен платный тариф.
`minutes.resets_at`	Дата следующего обновления минут по тарифу или `null`.
`limits`	Лимиты `requests_per_minute` и `max_active_jobs` для аккаунта.

Текущий тариф и дату продления API вернёт в plan и renews_at.

Если минуты закончились, POST /v1/transcriptions ответит 402 insufficient_minutes. В action_url будет ссылка на страницу «Billing». Когда баланс достигнет 0, мы также пришлём письмо — не больше одного за расчётный период.

Лимиты запросов

Один лимит действует на весь аккаунт: API-ключи, личный кабинет и MCP-подключения расходуют его вместе.

Запросов в минуту: 30 для Free, 200 для Monthly, 300 для Annual. Счётчик работает в минутных окнах.
В ответах /v1 на запросы с аутентификацией есть X-RateLimit-Limit — предел для аккаунта, и X-RateLimit-Remaining — остаток запросов в текущем окне.
При превышении получите 429 rate_limited. Заголовок Retry-After укажет, сколько секунд осталось до нового окна.
Отправка частей файла с токеном загрузки не расходует лимит запросов.

Сколько задач можно выполнять одновременно

Задача занимает место, пока у неё статус queued, fetching или transcribing. На Free доступны 2 места, на Monthly — 10, на Annual — 20. Если все заняты, создание новой задачи вернёт 429 too_many_active_jobs с Retry-After. Дождитесь завершения одной из текущих задач и повторите запрос.

Загрузка со статусом awaiting_upload места не занимает. Для неё есть отдельный предел: до 20 открытых загрузок на команду. При превышении вернётся тот же 429 too_many_active_jobs. Когда вы завершаете загрузку, задача попадает в очередь, поэтому в этот момент API уже проверяет лимит активных задач.

Порядок обработки ошибок описан в разделе «Ошибки».