Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex SpeechKit
  • Начало работы
  • Распознавание речи
    • О технологии
    • Потоковое распознавание
    • Распознавание аудиофайлов
      • Синхронное распознавание
      • Асинхронное распознавание
    • Модели распознавания
    • Расширение модели распознавания речи
    • Загрузка данных для дообучения модели
  • Синтез речи
    • О технологии
    • Список голосов
    • Настройка генерации речи
    • Использование SSML
    • Список поддерживаемых фонем в SSML
    • SpeechKit Brand Voice
      • О технологии SpeechKit Brand Voice
      • Формат входных данных Brand Voice Adaptive
      • Загрузка данных для Brand Voice
  • Форматы аудио
  • Интеграция телефонии
  • Использование API
    • Аутентификация в API
    • Формат ответа
    • Диагностика ошибок
    • Справочники API распознавания
      • API v2
        • API потокового распознавания
        • API синхронного распознавания
        • API асинхронного распознавания
      • API v3 gRPC (англ.)
        • Overview
        • Recognizer
    • Примеры использования API распознавания
      • Потоковое распознавание API v3
      • Потоковое распознавание API v2
      • Синхронное распознавание API v2
      • Асинхронное распознавание формата LPCM — API v2
      • Асинхронное распознавание формата OggOpus — API v2
    • Справочники API синтеза
      • API v1
      • API v3 gRPC (англ.)
        • Overview
        • Synthesizer
    • Примеры использования API синтеза
      • Синтез API v3
  • SpeechKit Hybrid
    • О технологии
    • Системные требования
    • Синтез речи
    • Распознавание речи
    • Мониторинг
    • Справочники API gRPC (англ.)
      • Аутентификация в API
      • Синтез речи
        • Overview
        • Synthesizer
      • Потоковое распознавание
        • Overview
        • Recognizer
  • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Релизы
    • Релизы распознавания
    • Релизы синтеза
    • Архив релизов
  • Публичные материалы
  • Вопросы и ответы
  1. Использование API
  2. Диагностика ошибок

Диагностика ошибок

Статья создана
Yandex Cloud
  • Заголовки запросов
    • Примеры
  • Заголовки ответов

Если у вас возникла ошибка при отправке запросов в API и вам нужна помощь, обратитесь в техническую поддержку.

Техническая поддержка сможет быстрее решить вашу проблему, если вы будете использовать дополнительные заголовки HTTP-запросов и ответов.

Заголовки запросов

При отправке HTTP-запросов используйте следующие заголовки:

  • x-client-request-id — уникальный идентификатор запроса. Рекомендуем использовать UUID. Сообщите этот идентификатор технической поддержке, чтобы мы смогли найти конкретрный запрос в системе и помочь вам.

    Вы можете сгенерировать UUID онлайн или воспользоваться библиотекой для используемого языка программирования.

  • x-data-logging-enabled — флаг, разрешающий сохранять данные, переданные пользователем в запросе.

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

Примеры

Например, используйте эти заголовки, чтобы потом сообщить, что ваше аудио распозналось плохо и помочь нам доработать модель распознавания.

Пример использования заголовков с помощью cURL:

  • folderId — идентификатор каталога, на который у вашего аккаунта есть роль editor или выше.
  • IAM_TOKEN — IAM-токен, необходимый для аутентификации.
export FOLDER_ID=<идентификатор каталога>
export IAM_TOKEN=<IAM-токен>

curl -X POST \
    -H "x-client-request-id: fa18fa9b-176d-4ae0-92b8-bd7897f7c00c" \
    -H "x-data-logging-enabled: true" \
    -H "authorization: Bearer ${IAM_TOKEN}" \
    --data-binary "@speech.ogg" \
    "https://stt.api.cloud.yandex.net/speech/v1/stt:recognize?folderId=${FOLDER_ID}"

Заголовки ответов

Каждый ответ сервера SpeechKit содержит заголовки, которые позволят получить еще больше информации о ходе выполнения запроса:

  • x-request-id — уникальный идентификатор ответа.
  • x-server-trace-id — уникальный идентификатор логов выполнения запроса.

Чтобы получить значения x-request-id и x-server-trace-id, ваше приложение должно логировать заголовки ответов сервера.

Пример реализации доступа к заголовкам протокола gRPC приведен в документации библиотеки grpc-go.

Была ли статья полезна?

Language / Region
© 2022 ООО «Яндекс.Облако»
В этой статье:
  • Заголовки запросов
  • Примеры
  • Заголовки ответов