API Anahtarı Metin Okuma: 5 Dakikada Başlarken

Sıfırdan çalışan metin okuma sesine ulaşmak, bu adımları izlerseniz beş dakika sürer. Bu kılavuz, bir API anahtarı almayı, ilk isteğinizi yapmayı ve anahtarı genel bir depoda sona ermemesi için güvence altına almayı kapsar.

Adım 1: Bir TTS API Anahtarı Alın

Speeko için:

1. speekoapp.com/register adresine gidin
2. Bir hesap oluşturun — kredi kartı gerekmez
3. Otomatik olarak 5$ ücretsiz kredi alın
4. Panoya gidin → API Anahtarları
5. "Yeni Anahtar Oluştur"a tıklayın
6. Anahtarı kopyalayın — sk-speeko-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx gibi görünür

Önemli: API anahtarları bir kez gösterilir. İletişim kutusunu kopyalamadan kapatırsanız, yeni bir tane oluşturmanız gerekir.

Adım 2: Anahtarı Güvenli Bir Şekilde Saklayın

Asla bir API anahtarını kodunuza sabit kodlamayın. Git geçmişinde sona erer ve potansiyel olarak açığa çıkar.

Bir ortam değişkeni olarak ayarlayın:

# ~/.zshrc veya ~/.bashrc'ye ekleyin
export SPEEKO_API_KEY="sk-speeko-anahtarınız-burada"

# Yeniden yükle
source ~/.zshrc

# Doğrula
echo $SPEEKO_API_KEY

Bir .env dosyasında (projeler için):

# .env
SPEEKO_API_KEY=sk-speeko-anahtarınız-burada

# Python: python-dotenv ile yükle
from dotenv import load_dotenv
import os

load_dotenv()
api_key = os.environ["SPEEKO_API_KEY"]

// Node.js: dotenv ile yükle
import 'dotenv/config';
const apiKey = process.env.SPEEKO_API_KEY;

Kritik: .env'yi .gitignore'a ekleyin:

echo ".env" >> .gitignore
git add .gitignore
git commit -m "Ignore .env files"

Yanlışlıkla bir anahtar taahhüt ederseniz, onu tehlikeye atılmış olarak kabul edin — panoda hemen döndürün.

Adım 3: İlk İsteğinizi Yapın

curl:

curl -X POST https://api.speekoapp.com/v1/tts \
  -H "X-API-Key: $SPEEKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba! API anahtarım çalışıyor.", "voice": "en-US-1", "format": "mp3"}' \
  --output first-request.mp3

# macOS: oynat
afplay first-request.mp3

# Linux: oynat
mpg123 first-request.mp3

Python:

import requests
import os

api_key = os.environ["SPEEKO_API_KEY"]

response = requests.post(
    "https://api.speekoapp.com/v1/tts",
    headers={
        "X-API-Key": api_key,
        "Content-Type": "application/json",
    },
    json={
        "text": "Merhaba! API anahtarım çalışıyor.",
        "voice": "en-US-1",
        "format": "mp3",
    },
)
response.raise_for_status()

with open("first-request.mp3", "wb") as f:
    f.write(response.content)

print(f"Başarılı! {len(response.content):,} bayt ses üretildi.")

Node.js:

import { writeFileSync } from 'fs';

const response = await fetch('https://api.speekoapp.com/v1/tts', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.SPEEKO_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    text: 'Merhaba! API anahtarım çalışıyor.',
    voice: 'en-US-1',
    format: 'mp3',
  }),
});

if (!response.ok) {
  const error = await response.text();
  throw new Error(`TTS başarısız oldu: ${response.status} - ${error}`);
}

const buffer = Buffer.from(await response.arrayBuffer());
writeFileSync('first-request.mp3', buffer);
console.log(`Başarılı! ${buffer.length.toLocaleString()} bayt üretildi.`);

Kimlik Doğrulama Başlığını Anlama

X-API-Key başlığı Speeko'ya özgüdür. Diğer sağlayıcılar farklı kimlik doğrulama kullanır:

API Anahtarı Güvenliği En İyi Uygulamaları

En az ayrıcalık ilkesi: API sağlayıcınız kapsamlı anahtarları (salt okunur, belirli uç noktalar) destekliyorsa, kullanım durumunuz için çalışan en sınırlı anahtarı kullanın.

Asla istemci tarafı kodunda değil: Bir tarayıcıda çalışan JavaScript'teki API anahtarları, Geliştirici Araçları'nı açan herkes tarafından görülebilir. TTS'yi tarayıcıdan değil, arka ucunuzdan çağırın.

// YANLIŞ — anahtar tarayıcı kullanıcılarına açık
const response = await fetch('https://api.speekoapp.com/v1/tts', {
  headers: { 'X-API-Key': 'sk-speeko-...' },  // Tarayıcı Geliştirici Araçları'nda görünür
});

// DOĞRU — anahtar sunucunuzda kalır
// Tarayıcı arka ucunuzu çağırır:
const audio = await fetch('/api/speak?text=Merhaba');
// Arka ucunuz Speeko'yu anahtarla çağırır:
// X-API-Key: process.env.SPEEKO_API_KEY

Anahtarları düzenli olarak döndürün: Yeni bir anahtar oluşturun, dağıtımınızı güncelleyin, ardından eskisini silin. Aylık döndürme, üretim anahtarları için makuldür.

Ortam başına ayrı anahtarlar: Geliştirme, hazırlık ve üretim için farklı anahtarlar kullanın. Bir geliştirme anahtarı sızarsa, üretim etkilenmez.

Erişim kontrolü: Ana anahtarınızı açığa çıkarmadan bir yükleniciyle bir anahtar paylaşın

• Bütçe uyarıları: Pano destekliyorsa anahtar başına harcama limitleri belirleyin

Gerektiği kadar anahtar oluşturun — hesap başına aktif API anahtarı sayısında bir sınır yoktur.

Sonraki Adımlar

Çalışan bir API anahtarınız var ve ses üretebilirsiniz. Yaygın sonraki adımlar:

• Uzun metni parçalayarak yönetme
• Önbelleğe alma ile maliyetleri düşürme
• SSML ile telaffuzu kontrol etme
• Gerçek zamanlı uygulamalar için ses akışı

speekoapp.com/register adresinden başlayın — 5$ ücretsiz kredi, kart gerekmez.