Урок из полного доступа, первые уроки курса бесплатно Официальный курс ElevenLabs Cookbook на русском
Урок 12 · Текст · ~5 мин

Настройка голосового движка: ключи и скрипт

Урок 12 из 21 курса «ElevenLabs: примеры»: официальный курс ElevenLabs Cookbook (Илевен Лабс) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Прежде чем писать какой-либо код, вызовите навык /speech-engine, чтобы изучить правильные паттерны ElevenLabs SDK.

  • Добавьте @elevenlabs/react, @elevenlabs/elevenlabs-js, openai, dotenv и tsx.
  • Добавьте скрипты: speech-engine:create (tsx scripts/create-engine.mts), speech-engine:enable-first-message (tsx scripts/enable-first-message.mts), speech-engine:server (tsx server.mts).
  • Задокументируйте ELEVENLABS_API_KEY, ELEVENLABS_SPEECH_ENGINE_ID, OPENAI_API_KEY и PUBLIC_WS_URL (wss://…/ws из ngrok).
  • Загрузите переменные окружения с помощью dotenv/config.
  • Создайте Speech Engine с помощью elevenlabs.speechEngine.create, используя speechEngine.wsUrl из PUBLIC_WS_URL.
  • Вызовите общий вспомогательный метод, чтобы включить overrides.firstMessage для нового ресурса.
  • Выведите engineId и инструкции для следующих шагов.
  • Обновите существующий Speech Engine (ELEVENLABS_SPEECH_ENGINE_ID), чтобы клиент мог установить overrides.agent.firstMessage.
  • Экспортируйте enableFirstMessageOverride(client, speechEngineId), используя speechEngine.update с overrides: { firstMessage: true }.
  • Общие вспомогательные методы API для ответов OpenAI: ASSISTANT_INSTRUCTIONS, isChatRole, normalizeChatMessages, transcriptToChatMessages, createAssistantReply(messages, signal) и createAssistantStream(messages, signal).
  • Сопоставьте роль agent Speech Engine с ролью assistant OpenAI; сохраняйте ответы лаконичными.
  • Нормализуйте историю перед отправкой в OpenAI: обрежьте содержимое, удалите пустые сообщения, ограничьте количество сообщений и длину каждого сообщения.
  • Добавьте небольшое локальное хранилище, которое позволяет приложению Next.js передавать набранную историю чата автономному серверу Speech Engine.
  • Храните нормализованные ChatMessage[] в .next/cache/voice-history.json по случайному historyId.
  • Экспортируйте createVoiceHistory(messages), linkVoiceHistory(conversationId, historyId) и loadVoiceHistory(conversationId).
  • Сохраняйте это только для демонстрации и с файловым хранением; без базы данных или слоя аутентификации.
  • Автономный HTTP-сервер на порту 3001 с speechEngine.attach(SPEECH_ENGINE_ID, httpServer, "/ws", { debug: true, … }).
  • onTranscript: загрузите любую набранную историю чата, связанную с session.conversationId, добавьте transcriptToChatMessages(transcript), передайте AbortSignal в createAssistantStream и session.sendResponse(stream).
  • Кэшируйте загруженную начальную историю для каждой беседы и кратковременно повторите попытку, поскольку браузер может связать историю сразу после создания голосовой беседы.
  • Записывайте в лог onInit, onClose и onError. Требуется ELEVENLABS_SPEECH_ENGINE_ID и OPENAI_API…

План урока

  1. 1. package.json
  2. 2. .env.example
  3. 3. scripts/create-engine.mts
  4. 4. scripts/enable-first-message.mts
  5. 5. lib/speech-engine-overrides.ts
  6. 6. lib/assistant.ts
  7. 7. lib/voice-history.ts
  8. 8. server.mts

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы ElevenLabs 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от ElevenLabs (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды