/create

Создать задачу на транскрибацию

POST https://gptunnel.ru/v1/audio/transcriptions

Распознавание речи выполняется асинхронно. Метод создаёт задачу и возвращает её id и status. Результат можно получить через webhook (callback_url) или методом /result.

Headers

Параметр	Тип	Описание
`Authorization`*	`string`	API ключ

Request Body

Параметр	Тип	Описание
`audio_url`*	`string`	Прямая публичная ссылка (http/https) на аудио или видео файл
`model`*	`string`	Модель: deepgram-whisper-tiny \| deepgram-whisper-medium \| deepgram-whisper-large
`language`	`string`	Код языка (например, "ru", "en"). Если не указан — язык определяется автоматически
`callback_url`	`string`	URL для отправки результата (webhook). Должен быть публичным

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

curl --request POST \
  --url https://gptunnel.ru/v1/audio/transcriptions \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "audio_url": "https://storage.yandexcloud.net/timenote/example.mp3",
    "model": "deepgram-whisper-large",
    "language": "ru"
}'

import axios from 'axios'

const response = await axios({
  method: 'POST',
  url: 'https://gptunnel.ru/v1/audio/transcriptions',
  headers: {
    Authorization: 'YOUR_API_KEY',
  },
  data: {
    audio_url: 'https://storage.yandexcloud.net/timenote/example.mp3',
    model: 'deepgram-whisper-large',
    language: 'ru',
  },
})

console.log(response.data)

import requests

response = requests.post(
    'https://gptunnel.ru/v1/audio/transcriptions',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={
        'audio_url': 'https://storage.yandexcloud.net/timenote/example.mp3',
        'model': 'deepgram-whisper-large',
        'language': 'ru',
    },
)

print(response.json())

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

{
  "code": 0,
  "id": "6a47bb78fb3f0d852e64c8e3",
  "status": "processing"
}

{
  "code": 3,
  "message": "Invalid input, check schema issues."
}

{
  "code": 8,
  "message": "Audio is too long. Maximum duration is 2 hours."
}

{
  "code": 9,
  "message": "Audio is too short. Minimum duration is 1 second."
}

{
  "code": 5,
  "message": "Insufficient balance, check account balance."
}

Полный справочник кодов ошибок — в разделе Справочник ошибок.

Результат будет доставлен на callback_url (если указан) или запрашивается методом /result.