İçeriğe geç

Discord Bot için TTS API’si: discord.js ile Tam Kurulum Rehberi (2026)

Audexum9 dkBy Petar

Audexum’un TTS API’sini ve discord.js’i kullanarak konuşma sentezleyen ve bunu bir ses kanalında oynatan bir Discord botu oluştur. Çalışan kodun tamamı dahil.

Discord’un yerleşik TTS’i (/tts) ilk beş dakika kullanışlıdır, sonra rahatsız edici hâle gelir. Gerçek bir sesle (robotik tarayıcı TTS değil) bir botun ses kanalında konuşmasını istiyorsanız harici bir TTS API'sine ihtiyacınız var. Bu kılavuz eksiksiz kurulumu kapsar: bir TTS API'si seçmek, discord.js v14 ile entegre etmek ve bir ses kanalında ses çalmak. Tüm kodlar kopyalayıp yapıştırmaya hazırdır.

Neye İhtiyacın Var?

  • Node.js 18+
  • A Discord bot application and token
  • A TTS API key (Audexum free tier works: 2,000 free credits + 250 a day, no credit card)
  • @discordjs/voice, discord.js, @discordjs/opus, and ffmpeg-static packages

Bot akışı şöyle: kullanıcı bir komut yazar → bot TTS API'sini çağırır → MP3 sesi alır → kullanıcının bulunduğu sesli kanalda oynatır.

Discord Botun için TTS API'si Seçmek

Discord botu kullanımındaki ana kısıtlamalarınız şunlardır: gecikme (ses kanalları etkileşimlidir), ölçekte maliyet (botlar hızla çok miktarda ses üretebilir) ve basitlik (ses klonlamaya ihtiyacınız yok; güvenilir bir REST uç noktasına ihtiyacınız var).

ProviderLatency (typical)Free TierCost at 1M charsAPI Simplicity
Audexum~300–700ms2K to start€28Simple REST, Bearer auth
ElevenLabs~400–900ms10K/mo (no commercial)$165–$200Good docs
OpenAI TTS~600–1200msNone$15Simple REST
Google Cloud TTS~200–500ms1M/mo (billing req.)$4–$16SDK or REST
AWS Polly~200–600ms5M (12-mo trial)$4SDK required

Discord botları için gecikme, toplu işleme hatlarına kıyasla daha önemlidir. Sağlayıcılar arasındaki fark belirgin şekilde hissedilir: 1 saniyenin üzerindeki her şey etkileşimli bir ses oturumunda yavaş hissettirir. Audexum'un REST API'si entegre etmesi en kolay olanıdır: SDK gerekmez, Bearer belirteç kimlik doğrulaması ve ikili ses yanıtı kullanır.

Bkz. Audexum ve ElevenLabs Karşılaştırması ayrıntılı maliyet dökümü için.

Proje Kurulumu

bash
mkdir discord-tts-bot && cd discord-tts-bot
npm init -y
npm install discord.js @discordjs/voice @discordjs/opus ffmpeg-static dotenv

Şunu oluştur: .env dosyası:

env
DISCORD_TOKEN=your_discord_bot_token
DISCORD_CLIENT_ID=your_application_client_id
AUDEXUM_API_KEY=your_audexum_api_key

Audexum API anahtarını şuradan al: audexum.com/signup. Ücretsiz katman (kayıt bonusu 2.000 kredi, ilk API anahtarını oluşturduğunda 250 kredi daha ve günde 250 kredi) bir bot prototiplemek için yeterli.

TTS Yardımcısı

Oluştur tts.js. API çağrısını gerçekleştirir ve ses çalmak için okunabilir bir akış döndürür:

javascript
// tts.js
const { Readable } = require("stream");

const AUDEXUM_API = "https://audexum.com/api/synthesize";

async function synthesize(text, voiceId = "af_heart") {
  const response = await fetch(AUDEXUM_API, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.AUDEXUM_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      text,
      voice: voiceId,
      format: "mp3",
    }),
  });

  if (!response.ok) {
    const body = await response.text();
    throw new Error(`Audexum API error ${response.status}: ${body}`);
  }

  // Convert the fetch body (Web ReadableStream) to a Node.js Readable
  return Readable.fromWeb(response.body);
}

module.exports = { synthesize };

Bot: Sesli Kanalda Oynatma

Oluştur bot.js, Discord komutlarını yönetir ve TTS sesini bir ses kanalına aktarır:

javascript
// bot.js
require("dotenv").config();
const {
  Client, GatewayIntentBits, REST, Routes, SlashCommandBuilder,
} = require("discord.js");
const {
  joinVoiceChannel, createAudioPlayer, createAudioResource,
  AudioPlayerStatus, StreamType,
} = require("@discordjs/voice");
const { synthesize } = require("./tts");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildVoiceStates,
    GatewayIntentBits.GuildMessages,
  ],
});

async function registerCommands() {
  const commands = [
    new SlashCommandBuilder()
      .setName("speak")
      .setDescription("Speak text in your current voice channel")
      .addStringOption((opt) =>
        opt.setName("text").setDescription("What to say").setRequired(true).setMaxLength(500)
      )
      .addStringOption((opt) =>
        opt.setName("voice").setDescription("Voice ID (optional)").setRequired(false)
      )
      .toJSON(),
  ];
  const rest = new REST().setToken(process.env.DISCORD_TOKEN);
  await rest.put(Routes.applicationCommands(process.env.DISCORD_CLIENT_ID), { body: commands });
  console.log("Slash commands registered.");
}

client.once("ready", async () => {
  console.log(`Logged in as ${client.user.tag}`);
  await registerCommands();
});

client.on("interactionCreate", async (interaction) => {
  if (!interaction.isChatInputCommand() || interaction.commandName !== "speak") return;

  const voiceChannel = interaction.member?.voice?.channel;
  if (!voiceChannel) {
    return interaction.reply({ content: "You need to be in a voice channel first.", ephemeral: true });
  }

  const text = interaction.options.getString("text");
  const voiceId = interaction.options.getString("voice") ?? "af_heart";

  await interaction.deferReply({ ephemeral: true });

  try {
    const audioStream = await synthesize(text, voiceId);

    const connection = joinVoiceChannel({
      channelId: voiceChannel.id,
      guildId: interaction.guildId,
      adapterCreator: interaction.guild.voiceAdapterCreator,
      selfDeaf: false,
    });

    const player = createAudioPlayer();
    const resource = createAudioResource(audioStream, { inputType: StreamType.Arbitrary });
    player.play(resource);
    connection.subscribe(player);

    player.on(AudioPlayerStatus.Idle, () => connection.destroy());
    player.on("error", (err) => { console.error("Player error:", err); connection.destroy(); });

    await interaction.editReply({ content: `Speaking: "${text}"` });
  } catch (err) {
    console.error("TTS error:", err);
    await interaction.editReply({ content: "Failed to synthesize audio. Check logs." });
  }
});

client.login(process.env.DISCORD_TOKEN);

Botu Çalıştırmak

bash
node bot.js

Discord'da /speak text:Merhaba, bu senin TTS botun komutunu bir sesli kanaldayken yaz. Bot katılır, metni okur, ardından ayrılır.

Discord Botları için Karakter Bütçesi

Discord botları beklediğinden daha hızlı karakter tüketebilir. Birkaç senaryo:

Use CaseAvg chars/commandCommands/dayMonthly total
Server announcements2005~30,000
Game event narration15020~90,000
Music bot track announces80100~240,000
Full assistant bot30050~450,000

Zaman zaman kullanılan küçük bir topluluk sunucusunda Audexum'un günlük 250 ücretsiz kredisi (ayrıca başlangıç için 2.000 kredi) yeterlidir. Aktif bir oyun sunucusu için €29/ay plan (1,2M kredi) gerçekçi aralıktır. Bkz. audexum.com/pricing tüm plan ayrıntıları için.

Yönlendirme programı da burada geçerlidir: Audexum yönlendirme kodunu topluluğunla paylaş. Kodunla yapılan her kayıt, aylık ücretsiz kredilerin üzerine her iki hesaba da bonus ücretsiz kredi ekler. Bir Discord sunucusunda bu, sürdürülebilir ücretsiz kullanım anlamına gelebilir.

Kullanıcılar için Ses Seçimi Eklemek

Yaygın bir yaklaşım, kullanıcıların bir ses listesinden seçim yapmasına izin vermektir. Slash komut seçeneklerini genişlet:

javascript
.addStringOption((opt) =>
  opt
    .setName("voice")
    .setDescription("Choose a voice")
    .setRequired(false)
    .addChoices(
      { name: "Heart (American · F)", value: "af_heart" },
      { name: "Michael (American · M)", value: "am_michael" },
      { name: "Emma (British · F)", value: "bf_emma" },
      { name: "George (British · M)", value: "bm_george" }
    )
)

Tam ses listesini şurada kontrol et: audexum.com/docs. 32 dilde 43 ses bulunur, bu sayede tek botla çok dilli toplulukları destekleyebilirsin.

Hız Sınırlarını ve Hataları Düzgün Şekilde Yönetmek

Üretim botları için API çağrısının etrafına basit bir yeniden deneme sarmalayıcısı ekle:

javascript
async function synthesizeWithRetry(text, voiceId, maxRetries = 2) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      return await synthesize(text, voiceId);
    } catch (err) {
      if (attempt === maxRetries) throw err;
      await new Promise((r) => setTimeout(r, 1000));
    }
  }
}

Yüksek trafikli botlarda karakter kullanımını kendi veritabanında izle ve plan sınırlarına ulaşmadan önce uyarı gönder.

Discord Botu TTS için Alternatifler

  • Google Cloud TTS: En iyi ücretsiz hacim (ayda 4M standart + 1M WaveNet/Neural2 karakter), faturalandırma hesabı gerektirir. SDK ile biraz daha karmaşık kurulum, ama ölçekte güvenilir.
  • OpenAI TTS: Ücretsiz katman yok, $15/1M karakter. Zaten OpenAI API'leri için ödeme yapıyorsanız ve faturalamayı birleştirmek istiyorsanız gerekçelidir. Daha uzun ifadelerde iyi ses kalitesi sunar.
  • ElevenLabs: Yüksek ses kalitesi, ticari hakları olmayan 10K ücretsiz karakter. Bot ölçeğinde maliyet hızla artar. Tam karşılaştırma burada.
  • Kendi Sunucunda Barındırma (Coqui/Piper): Çalıştıktan sonra sıfır API maliyeti; ancak GPU veya CPU kaynaklarına sahip bir sunucu, sürekli bakım ve model yönetimi gerektirir.

Botu Dağıtmak

Üretim ortamında botu pm2 tarafından yönetilen bir süreç olarak çalıştır:

bash
pm2 start bot.js --name discord-tts-bot
pm2 save

Emin ol: .env dosyası korunuyor (chmod 600 .env) ve sürüm kontrolüne eklenmiyor.


Audexum'un kurucusu Petar tarafından. Discord botu kullanım senaryosu, lansmandan sonra insanların ilk sorduğu şeylerden biriydi. Bu kılavuz, ilk entegrasyonu kurarken var olmasını umduğum şeyi tam olarak kapsıyor.

Got any questions left?

Geri bildirim paylaş

Bu makale faydalı oldu mu?

Sonraki yazıYouTube Transkripti Nasıl Alınır: 4 Yöntem Karşılaştırma (2026)

Ücretsiz başlayın. Kart yok.

2,000 başlangıç kredisi, 250 her gün daha fazlası.