Logo

ДОКУМЕНТАЦИЯ

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

Аутентификация осуществляется с помощью API-ключа, который передается в заголовке Authorization в формате Bearer. Получить API-ключ можно в личном кабинете.

Включите API-ключ в каждый запрос следующим образом:

Транскрибация

API Scribex предоставляет эндпоинт для транскрипции аудио- или видеофайлов в текст через POST https://api.scribex.ru/v1/transcribe

Тело запроса

Запрос должен быть отправлен в формате multipart/form-data со следующим полем:

ПолеТипОписание
audiostring или fileОбязательное. Либо URL-адрес публично доступного аудио-/видеофайла, либо прямое вложение файла.

Ответ

API возвращает JSON-объект с результатами транскрипции.

Пример ответа:

Примеры запросов

Пример с использованием URL:

Пример с загрузкой файла:

Поддерживаемые форматы

API Scribex поддерживает следующие форматы аудио- и видеофайлов:

  • Аудио: .mp3, .wav, .flac, .ogg, .opus, .m4a
  • Видео: .webm, .mp4

Ограничения и лимиты

API ScribeX имеет следующие ограничения на запросы, размер файлов и длительность аудио:

  • Лимит запросов: 30 запросов в минуту. При превышении возвращается ошибка 429.
  • Максимальный размер файла: 1 ГБ. Максимальный размер загружаемого файла (для прямой загрузки или скачивания по URL). При превышении возвращается ошибка 400.
  • Минимальная длительность аудио: 1 секунда. Длительность округляется до 1 секунды для расчета стоимости.
  • Максимальная длительность аудио: 10 часов. При превышении возвращается ошибка 400.

Для увеличения лимитов свяжитесь с поддержкой по адресу info@scribex.ru

Возможные ошибки

API ScribeX использует стандартные HTTP коды ответов для указания успеха или неудачи запросов.

Код ошибкиЗаголовокОписание
400Bad Request: Invalid form-dataНеверный формат данных формы multipart/form-data.
400Bad Request: File size exceeds 100 MBРазмер загруженного файла превышает 100 МБ.
400Bad Request: Unsupported file format.Формат файла не поддерживается.
400Bad Request: Audio must be a file or URLПараметр audio должен быть файлом или URL, начинающимся с http.
400Bad Request: Failed to process audio inputНе удалось обработать входной аудиофайл (например, недоступный URL).
400Bad Request: Audio duration exceeds 60 minutesДлительность аудио превышает 60 минут.
402Payment Required: Insufficient fundsНедостаточно средств на балансе для оплаты транскрипции.
403Forbidden: Missing API keyAPI-ключ не указан в заголовке Authorization.
403Forbidden: Invalid API keyУказанный API-ключ недействителен или не зарегистрирован.
429Too Many RequestsПревышен лимит запросов (30 в минуту).

Поддерживаемые языки

API Scribex поддерживает транскрипцию для широкого спектра языков. Язык определяется автоматически нашей системой.

Код языкаНазвание языка
afАфрикаанс
amАмхарский
arАрабский
asАссамский
azАзербайджанский
baБашкирский
beБелорусский
bgБолгарский
bnБенгальский
boТибетский
brБретонский
bsБоснийский
caКаталанский
csЧешский
cyВаллийский
daДатский
deНемецкий
elГреческий
enАнглийский
esИспанский
etЭстонский
euБаскский
faПерсидский
fiФинский
foФарерский
frФранцузский
glГалисийский
guГуджарати
haХауса
hawГавайский
heИврит
hiХинди
hrХорватский
htГаитянский креольский
huВенгерский
hyАрмянский
idИндонезийский
isИсландский
itИтальянский
jaЯпонский
jwЯванский
kaГрузинский
kkКазахский
kmКхмерский
knКаннада
koКорейский
laЛатинский
lbЛюксембургский
lnЛингала
loЛаосский
ltЛитовский
lvЛатышский
mgМалагасийский
miМаори
mkМакедонский
mlМалаялам
mnМонгольский
mrМаратхи
msМалайский
mtМальтийский
myБирманский
neНепальский
nlНидерландский
nnНюнорск
noНорвежский
ocОкситанский
paПанджаби
plПольский
psПушту
ptПортугальский
roРумынский
ruРусский
saСанскрит
sdСиндхи
siСингальский
skСловацкий
slСловенский
snШона
soСомалийский
sqАлбанский
srСербский
suСунданский
svШведский
swСуахили
taТамильский
teТалугу
tgТаджикский
thТайский
tkТуркменский
tlТагальский
trТурецкий
ttТатарский
ukУкраинский
urУрду
uzУзбекский
viВьетнамский
yiИдиш
yoЙоруба
yueКантонский
zhКитайский