API Документация

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

Для использования API необходимо передавать API ключ в заголовке X-API-Key.

X-API-Key: YOUR_API_KEY

1. Отправка файла на транскрибацию

Endpoint: POST https://audio.serg95off.ru/api/transcribe

Content-Type: multipart/form-data

Параметры:

file - аудио/видео файл (обязательно)
type - тип файла: audio или video (обязательно)

Пример запроса (curl):

curl -X POST https://audio.serg95off.ru/api/transcribe \
  -H "X-API-Key: test_key_123" \
  -F "file=@/path/to/audio.mp3" \
  -F "type=audio"

Пример успешного ответа (200):

{
  "status": "success",
  "code": 200,
  "job_id": "job_67a8f3d1e2c3b",
  "message": "File accepted for processing"
}

2. Проверка статуса и результата

Endpoint: GET https://audio.serg95off.ru/api/status?job_id={JOB_ID}

Пример запроса (curl):

curl -X GET "https://audio.serg95off.ru/api/status?job_id=job_67a8f3d1e2c3b" \
  -H "X-API-Key: test_key_123"

Пример ответа (обработка):

{
  "status": "success",
  "code": 200,
  "job_id": "job_67a8f3d1e2c3b",
  "job_status": "processing",
  "result": null
}

Пример ответа (завершено):

{
  "status": "success",
  "code": 200,
  "job_id": "job_67a8f3d1e2c3b",
  "job_status": "completed",
  "result": {
    "text": "Пример транскрибированного текста...",
    "segments": [
      {"start": 0, "end": 5.2, "text": "Первый сегмент текста"},
      {"start": 5.2, "end": 10.8, "text": "Второй сегмент текста"}
    ],
    "duration": 15.5,
    "language": "ru"
  }
}