API Транскрибации
Отправляйте медиа для AI транскрибации и создания проекта. Поддерживаются как Видео, так и Аудио файлы.
POST
/api/v1/transcribeБыстрая реализация
curl -X POST https://api.srtgen.com/api/v1/transcribe \ -H "x-api-key: <YOUR_API_KEY>" \ -F "file=@/path/to/your/video.mp4"
POSThttps://api.srtgen.com/api/v1/transcribe
Параметры запроса
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
file | File | Yes | Медиафайл для транскрибации (Multipart). Поддерживаются: Видео (mp4, mov, avi, webm, mkv), Аудио (mp3, wav, m4a, flac). Макс. 2 ГБ. |
videoUrl | String | No* | Внешний URL медиа (обязателен, если файл не указан в теле запроса). |
name | String | No | Пользовательское имя для проекта. |
languageCode | String | No | Код исходного языка (например, 'en-us'). По умолчанию 'auto' (автоопределение), если пропущено. |
filterProfanity | Boolean | No | Нужно ли автоматически подвергать цензуре нецензурные слова. По умолчанию false. |
disfluencies | Boolean | No | Нужно ли включать слова-паразиты (например, 'э-э', 'м-м'). По умолчанию false. |
Дополнительно: URL + Настройки AI
curl -X POST https://api.srtgen.com/api/v1/transcribe \ -H "x-api-key: <YOUR_API_KEY>" \ -F "videoUrl=https://example.com/video.mp4" \ -F "languageCode=en-us" \ -F "filterProfanity=true" \ -F "disfluencies=false"
POSThttps://api.srtgen.com/api/v1/transcribe
Успешный ответ
Успешный запрос возвращает статус 200 OK с деталями проекта и фоновой задачи.
- projectIdУникальный идентификатор вашего проекта.
- status'inProgress' (транскрибация в процессе).
- Примечание: Кредиты рассчитываются и списываются с вашего баланса асинхронно после завершения процесса транскрибации.
{ "success": true, "projectId": "proj_8k2n9m1b", "status": "inProgress" }
Коды ошибок
| Статус | Код ошибки | Описание |
|---|---|---|
| 400 | missing_file | Файл не найден в поле 'file' или 'video'. |
| 400 | unreachable_url | Указанный videoUrl недоступен или вернул ошибку. |
| 400 | invalid_parameter | Один из параметров (например, videoUrl) имеет неверный формат. |
| 400 | file_read_failed | Загруженный файл не удалось прочитать или он поврежден. |
| 401 | unauthorized | Ключ API отсутствует или недействителен. |
| 403 | insufficient_balance | У вас недостаточно кредитов для обработки медиа такой длительности. |
| 403 | storage_quota_exceeded | Файл превышает оставшуюся квоту облачного хранилища вашего тарифа. |
| 413 | payload_too_large | Файл превышает абсолютный системный лимит загрузки в 2 ГБ. |
| 500 | transcription_failed | Не удалось запустить задачу транскрибации (сбой поставщика AI). |
| 500 | server_error | Что-то пошло не так, пожалуйста, попробуйте позже. |
Структура ответа с ошибкой
{ "success": false, "error": "insufficient_balance", "message": "Для вашего проекта требуется 5 кредитов, но ваш баланс составляет 2." }
Была ли эта страница полезна?