İstemler ve Otomasyon

ElevenLabs API Anahtarı Nasıl Alınır? Güvenli Saklama ve Türkçe Ses Örneği

ElevenLabs API anahtarı, hesabınızdaki ayarlarda yer alan API anahtarları sayfasından (elevenlabs.io/app/settings/api-keys) oluşturulur ve istekte xi-api-key başlığıyla gönderilir. ElevenLabs anahtarın gizli tutulmasını, tarayıcı ya da uygulama kodunda açığa çıkarılmamasını istiyor; her anahtara uç nokta kısıtı, kredi sınırı ve IP izin listesi verilebiliyor. Kod örneğini Yadem Reklam hazırladı.

Güncellendi: 18 Ekim 20263 dk okumaHazırlayan: Yadem Reklam ekibi
ElevenLabs API Anahtarı Nasıl Alınır? Güvenli Saklama ve Türkçe Ses Örneği – Yadem Reklam
Anahtar nereden alınır?

ElevenLabs hesabınızdaki API anahtarları sayfasından: elevenlabs.io/app/settings/api-keys.

İstekte nasıl kullanılır?

HTTP isteğinde xi-api-key başlığıyla; SDK'da ise anahtarı ELEVENLABS_API_KEY ortam değişkeninden okuyarak.

Anahtar sızarsa zarar sınırlanabilir mi?

Evet: her anahtara erişebileceği uç noktalar, kredi sınırı ve IP izin listesi tanımlanabiliyor; izinsiz IP'den gelen istek 403 ile reddediliyor.

API ücreti nasıl hesaplanıyor?

API fiyat sayfasına göre API kullanımı krediyle değil dolarla, metinden konuşmada karakter sayısına göre faturalanıyor.

ElevenLabs API anahtarı nasıl alınır? 5 adım

ElevenLabs API anahtarı, hesaba girip API anahtarları sayfasında yeni anahtar oluşturarak alınır; anahtar daha sonra gizli bir ortam değişkenine konur ve kod bu değişkenden okur. Adımlar ElevenLabs’in 18 Ekim 2026’daki hızlı başlangıç ve kimlik doğrulama belgelerine dayanıyor.

  1. Hesaba girin: elevenlabs.io’da oturum açın.
  2. Anahtar sayfasını açın: Ayarlardaki API anahtarları sayfasına gidin; hızlı başlangıç belgesi doğrudan elevenlabs.io/app/settings/api-keys adresini veriyor.
  3. Anahtarı oluşturun ve sınırlayın: Gerekirse anahtarın erişebileceği uç noktaları kısıtlayın, kredi sınırı koyun ve IP izin listesi tanımlayın.
  4. Gizli değişkene koyun: Belge anahtarın yönetilen bir gizli bilgi olarak saklanmasını öneriyor; yerelde .env dosyasında ELEVENLABS_API_KEY=… satırıyla tutun ve bu dosyayı sürüm kontrolüne eklemeyin.
  5. SDK’yı kurun: Python için pip install elevenlabs python-dotenv, TypeScript için npm install @elevenlabs/elevenlabs-js dotenv.

Anahtarı aldıktan sonra Türkçe seslendirmenin model ve okunuş hazırlığı için ElevenLabs Türkçe seslendirme yazımıza bakın; üretilen sesin videoya nasıl oturtulduğu video kurgu nasıl yapılır rehberimizde.

API anahtarı güvenli nasıl saklanır?

API anahtarı güvenli saklamanın temeli, anahtarı koda, tarayıcıya ya da mobil uygulamaya hiç yazmamak ve yalnız sunucu tarafında, ortam değişkeninden okumaktır; ElevenLabs anahtarın bir sır olduğunu ve istemci tarafı kodda açığa çıkarılmaması gerektiğini açıkça yazıyor. Tarayıcıdan doğrudan bağlanmanız gereken bazı uç noktalar için ElevenLabs süreli, tek kullanımlık jetonlar sunuyor.

KorumaNe sağlar?
Kapsam (scope) kısıtıAnahtar yalnız izin verilen uç noktalara erişir
Kredi sınırıAnahtar başına harcama tavanı
IP izin listesiListede olmayan IP’den gelen istek 403 hatasıyla reddedilir
Tek kullanımlık jetonİstemci tarafında anahtarı göstermeden sınırlı süreli bağlantı

Son kontrol: 18 Ekim 2026. Bir projeye ayrı anahtar açıp kredi sınırı koymak, anahtar sızarsa zararı o tavanla sınırlar. Otomasyonlarda veri ve talimat ayrımı için prompt injection nedir yazımıza da göz atın.

Anahtarı göstermeden Türkçe ses üreten örnek kod

Aşağıdaki Python örneği anahtarı ELEVENLABS_API_KEY ortam değişkeninden okuyor, Eleven v4 ile Türkçe bir cümleyi seslendiriyor ve sonucu dis_ses.mp3 dosyasına yazıyor; dosyaya yazma döngüsü ElevenLabs’in kendi örneğindeki gibidir. Kodu 18 Ekim 2026’da sözdizimi açısından derleyerek denedik; kredi harcamamak için çalıştırmadık.

import os
from elevenlabs.client import ElevenLabs

# Anahtar kodda değil, ortam değişkeninde: ELEVENLABS_API_KEY
client = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))

yanit = client.text_to_speech.convert(
    voice_id="SES_KIMLIGI",
    model_id="eleven_v4",
    text="Merhaba! Bu dış ses ElevenLabs API ile üretildi.",
    language_code="tr",
    output_format="mp3_44100_128",
)

with open("dis_ses.mp3", "wb") as f:
    for parca in yanit:
        if parca:
            f.write(parca)
  • voice_id: Ses Kitaplığı’ndan ya da kendi klonunuzdan alınan kimlik; ücretsiz planda Ses Kitaplığı sesleri API’de kullanılamıyor.
  • language_code: “tr”: Dili zorlar; Multilingual v2 modelinde desteklenmiyor.
  • output_format: Varsayılan mp3_44100_128; daha yüksek kalite seçenekleri ücretli planlarda.

Ham HTTP isteğinde aynı iş POST https://api.elevenlabs.io/v1/text-to-speech/{voice_id} adresine, xi-api-key başlığıyla JSON gövde gönderilerek yapılır. Çok konuşmacılı istek için ElevenLabs ile diyalog oluşturma yazımıza bakın.

ElevenLabs API kullanımı nasıl ücretlendirilir?

ElevenLabs API kullanımı krediyle değil dolarla faturalanır ve metinden konuşma karakter sayısına göre ücretlendirilir: API fiyat sayfasına göre 1.000 karakter Eleven v4 için 0,08 dolar, v4 Turbo ve Flash/Turbo için 0,04 dolar (18 Ekim 2026, vergiler hariç, değişebilir). Ticari kullanım hakkı yalnız ücretli planlarda veriliyor.

Kendi Türkçe üretimimizde bir dakikalık ham anlatım 852 karakter tuttu; bu, Eleven v4 API’siyle dakikada yaklaşık 0,068 dolar demek. Plan ve kredi hesabının tamamı ElevenLabs fiyatlandırması yazımızda.

API anahtarı hangi işlerde gerekir?

API anahtarı, seslendirmeyi bir yazılımdan otomatik çağırmanız gereken her işte gerekir: toplu dış ses üretimi, bir uygulamanın içinde konuşan asistan, içerik akışında metni sese çeviren bir otomasyon ya da kurgu programına ses dosyası hazırlayan bir betik. Elle birkaç seslendirme yapacaksanız sitedeki arayüz yeterlidir.

Seri dış ses üretimini bizim yürütmemizi isterseniz yüzsüz YouTube kanalı içerik üretimi ve video kurgu sayfalarımıza bakın; ham görüntü kurgusu dakikası 750 TL. Dış sesin müzikle dengesi için video ses düzenleme, reklam metninin seslendirmesi için reklam filmi seslendirme, yapay zekâ sesi kullanan reklamların kuralları için yapay zekâ reklam yasal durum sayfalarına bakın. Diğer bir sağlayıcının anahtar adımları için OpenAI API anahtarı yazımızı okuyabilirsiniz.

Sık sorulan sorular

ElevenLabs API key ücretsiz mi?

Ücretsiz hesapla da anahtar oluşturulabiliyor; ancak ücretsiz planda Ses Kitaplığı sesleri API üzerinden kullanılamıyor ve ticari kullanım hakkı yalnız ücretli planlarda var.

ElevenLabs API key nereye yazılır?

Koda değil, ELEVENLABS_API_KEY ortam değişkenine; HTTP isteğinde xi-api-key başlığıyla gönderilir. Tarayıcı ya da mobil uygulama koduna asla yazmayın.

ElevenLabs API anahtarım sızdıysa ne yapmalıyım?

Anahtarı API anahtarları sayfasından iptal edip yenisini oluşturun ve yeni anahtarı yalnız ortam değişkenine koyun. Kredi sınırı ve IP izin listesi tanımlamak sonraki riski azaltır.

ElevenLabs API'de 403 hatası neden alınır?

Kimlik doğrulama belgesine göre IP izin listesi tanımlı bir anahtarla listede olmayan bir IP'den gelen istekler 403 ile reddediliyor. Anahtarın kapsam kısıtını da kontrol edin.

ElevenLabs API Türkçe destekliyor mu?

Evet. Eleven v4 ve diğer çok dilli modeller Türkçeyi destekliyor; istekte language_code: "tr" ile dili zorlayabilirsiniz (Multilingual v2 hariç).

Sıradaki adım

Dış ses otomasyonunuzu birlikte kuralım

İhtiyacınızı WhatsApp'tan yazın; anahtar güvenliğinden ses kontrolüne kadar seri dış ses üretimini planlayalım ya da sizin için yürütelim.

WhatsApp'tan yazın