Вебхуки

По умолчанию каждый запрос отправленный в Connecte выполняется в асинхронном режиме. Некоторые из них могут занимать значительное время, например, транскрибация видео, когда требуется обработать файлы больших размеров. В таких случаях вы можете использовать инструмент для получения уведомлений о ваших прогнозах в реальном времени — вебхуки.

Использование вебхуков довольно просто. При создании запроса на инференс, вы указываете URL-адрес конечной точки. Система будет отправлять HTTP POST-запросы на этот адрес при завершении предсказания с определенным статусом.

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

Отправим запрос на инференс, в теле укажем дополнительный параметр webhook:

                                        curl https://connecte.ai/api/v1/openai/whisper \
--request POST \
--header "Authorization: Bearer $CONNECTE_TOKEN" \
--header "Content-Type: application/json" \
--data '{
            "audio" : "https://site.ru/audio.mp3",
            "webhook" : "https://you-app.ru/connecte-webhook"
        }'
                                        
                                    

Получим ответ похожий на:

                                        {
  "id":"d5a46834-c430-4342-9779-4ea5e76d057d",
  "input":{
      "audio":"https://you-app.ru/fortranscribeIulHuaFesg.mp3",
      "model":"large-v3-turbo",
      "diarize":false,
      "language":"auto",
      "speakers":1,
      "word_timestamp":false
  },
  "status":"starting",
  "output":null,
  "source":"api",
  "webhook":"https://you-app.ru/connecte-webhook",
  "runtime":null,
  "created_at":"2024-06-26T05:26:31.974000Z"
}
                                        
                                    

Как только прогноз сменит статус на один из ['Succeeded', 'Failed', 'Canceled'] вы получите уведомление похожее на это:

                                        {
  "id":"d5a46834-c430-4342-9779-4ea5e76d057d",
  "input":{
      "audio":"https://you-app.ru/fortranscribeIulHuaFesg.mp3",
      "model":"large-v3-turbo",
      "diarize":false,
      "language":"auto",
      "speakers":1,
      "word_timestamp":false
  },
  "status":"succeeded",
  "output":{
    "segments":{...},
    "transcription":{...},
    "translation":{...},
    "detected_language":{...}
  },
  "source":"api",
  "webhook":"https://you-app.ru/connecte-webhook",
  "runtime":39.2,
  "created_at":"2024-06-26T05:26:31.974000Z"
}
                                        
                                    

Подробнее о вебхуках