← На главную

API для разработчиков

Озвучка текста, расшифровка записей и субтитры — из ваших программ, скриптов и ботов. Те же возможности и лимиты, что на сайте у вошедшего пользователя.

Загружаю…

Как это работает

  1. Войдите на сайт через Яндекс ID, VK ID или почту и выпустите ключ выше. Ключ показывается один раз — сохраните его.
  2. Передавайте ключ в заголовке Authorization: Bearer artel_….
  3. Создайте задачу (POST /api/t/job) — в ответе id и secret.
  4. Опрашивайте статус (GET /api/t/job/{id}?s={secret}) раз в 2–5 секунд, пока status не станет done или error.
  5. Скачайте файлы из списка files: GET /api/t/file/{id}/{name}?s={secret}.

Озвучка «Вера» — как на сайте

С 10 октября 2026 озвучка на сайте — «Вера»: от вас только текст и диктор, ударения, числа и паузы расставляются автоматически. Запрос с ключом — это запрос вошедшего пользователя: озвучивается весь текст: первые 200 знаков — бесплатно (до 3 раз в сутки), остальное — за токены (5 токенов за 100 знаков; при нехватке недостающее берётся из «пауэрбанка», если он заряжен); запись делается целиком, до оплаты доступны отрывки, токены списываются по pay. Без ключа запрос считается гостевым, как на сайте: бесплатно озвучиваются только первые 100 знаков, до 3 озвучек в сутки с одного IP-адреса. Условия и дикторы — в поле vera ответа GET /api/t/limits. Текст с персональными данными не принимается (kind: pd; при подозрении на имена — kind: pd_soft, повторите с "pd_ok":"1").

curl -s https://ai-artel.ru/api/v/job -H "Authorization: Bearer $ARTEL_KEY" -H "Content-Type: application/json" \
  -d '{"text":"Здравствуйте! Заказ на 2500 рублей привезём 15 октября к 10:00.","voice":"exp_leda","rules":"1"}'
# {"ok":true,"id":"261010-ab12cd","secret":"…","mode":"paid","need":4,"chars":63}
curl -s "https://ai-artel.ru/api/v/job/$ID?s=$SECRET"          # status, progress; готово — full (ссылка на MP3) или clips (отрывки до оплаты)
curl -s -X POST -H "Authorization: Bearer $ARTEL_KEY" "https://ai-artel.ru/api/v/job/$ID/pay?s=$SECRET"   # платная запись: списать токены и открыть MP3
ПолеЗначение
textДо 20 000 знаков. Больше 100 — нужен ключ вошедшего пользователя и токены на балансе.
voiceЖенские: exp_leda — Вера (по умолчанию), exp_kore — Ксения, exp_aoede — Анна, exp_zephyr — Зоя; мужские: exp_orus — Олег, exp_charon — Константин, exp_fenrir — Фёдор, exp_puck — Павел.
rules"1" — согласие с правилами (обязательно).

Озвучка текста — расширенные варианты (только API)

Прежние варианты озвучки (стандартная, улучшенные 1–3) отключены: запрос /api/t/job с service=voice при любом engine озвучивается голосом Веры (Э1) — за токены, как /api/v/job. Голоса стандартной и улучшенных заменяются голосом по умолчанию.

curl -s https://ai-artel.ru/api/t/job \
  -H "Authorization: Bearer $ARTEL_KEY" \
  -F service=voice -F voice=live_maria -F engine=live2 \
  -F text="Здравствуйте! Заказ на 2500 рублей привезём 15 октября к 10:00."
# {"ok":true,"id":"261009-ab12cd","secret":"…","url":"/j/261009-ab12cd-…"}
ПолеЗначение
textТекст до 100 000 знаков. Числа, даты и суммы читаются словами. Пауза — [пауза 2], ударение — + перед ударной гласной (для std и live).
engineбыстрая: std — стандартная; медленные: live, live2, live3 — улучшенные 1, 2 и 3. exp1 — экспериментальная Э1 (бета): только по ключу вошедшего пользователя, 5 токенов за 100 знаков, голоса exp_orus, exp_charon, exp_fenrir, exp_puck (мужские), exp_kore, exp_aoede, exp_leda, exp_zephyr (женские); текст с персональными данными не принимается (ответ kind: pd), при подозрении на имена — kind: pd_soft, повторите с pd_ok=1, если это не персональные данные. Улучшенные — за токены: 1 токен = 100 знаков, баланс — GET /api/t/tokens, в ответе на создание задачи — tokens_spent и tokens_left.
voiceДля std: ru_ekaterina, ru_oksana, ru_vika, ru_karina, ru_zinaida, ru_albina, ru_eduard, ru_alexandr, ru_dmitriy, ru_igor, ru_roman, ru_bogdan.
Для улучшенных: live_maria, live_svetlana, live_dmitriy, live_timofey.
autostress1 (по умолчанию) — расставить ударения автоматически, 0 — только ваши +.
pausesАвтопаузы: para (по умолчанию) — между абзацами и после заголовков, slow — ещё и после каждого предложения, text — только по знакам препинания и вашим [пауза N].
punct1 — расставить знаки препинания в абзацах, где их почти нет (текст из расшифровки, переписки).
speedСкорость речи для любого варианта: slow — медленно, normal (по умолчанию), fast — быстро. Высота голоса не меняется.

Результат — voice.mp3.

Расшифровка и субтитры

# файл
curl -s https://ai-artel.ru/api/t/job -H "Authorization: Bearer $ARTEL_KEY" \
  -F service=trans -F diar=1 -F file=@interview.mp3
# или ссылка (Яндекс Диск, VK Видео, Rutube)
curl -s https://ai-artel.ru/api/t/job -H "Authorization: Bearer $ARTEL_KEY" \
  -F service=subs -F burn=1 -F style=yellow -F url="https://disk.yandex.ru/i/…"
ПолеЗначение
servicetrans — расшифровка в текст, subs — субтитры, voice — озвучка.
file / urlАудио или видео: файлом (multipart) или ссылкой.
diar1 — разделить по говорящим (для trans).
burn, styleburn=1 — вшить субтитры в видео; стиль classic, yellow, box, big.

Файлы результата: transcript.txt, transcript-plain.txt, transcript.docx, subtitles.srt, subtitles.vtt, video-subtitles.mp4.

Статус и скачивание

curl -s "https://ai-artel.ru/api/t/job/$ID?s=$SECRET"
# {"status":"working","progress":0.42,...}  →  {"status":"done","files":[{"name":"voice.mp3",...}],...}
curl -s -o voice.mp3 "https://ai-artel.ru/api/t/file/$ID/voice.mp3?s=$SECRET"
curl -s -H "Authorization: Bearer $ARTEL_KEY" https://ai-artel.ru/api/t/limits   # остаток лимитов на сегодня

Лимиты и правила