TTS API Hızlı Başlangıç Kılavuzu

Base URL ve Kimlik Doğrulama

İstemcinizi temel URL'mize işaret edecek şekilde yapılandırarak başlayın: https://api.ttsapihub.com/v1. API'miz tamamen OpenAI ile uyumludur, bu nedenle base_url değerini güncelleyerek ve API anahtarınızı sağlayarak standart SDK'ları kullanabilirsiniz. Kimlik doğrulama, Bearer token içeren Authorization başlığı aracılığıyla yapılır. API anahtarını Get API key sayfasındaki kayıt sırasında oluşturursunuz. Her hesap için yalnızca bir aktif anahtar vardır ve bu anahtarı istediğiniz zaman yenileyebilirsiniz. İstemleriniz eğitim için kullanılmaz ve deneme kredisi ile başlamak için telefon numarası veya kredi kartı gerekmez.

Chat Completions ile Metin Oluşturma

Metin oluşturmak için standart POST /v1/chat/completions isteğini gönderin. Kullanılacak model kimliği uncensored şeklindedir. Bu model, yasal yetişkin kullanımında içerik reddetmeleri olmadan yanıt verecek şekilde ayarlanmış açık ağırlıklı bir LLM'dir; kurumsal filtrelerin içeriğinizi engellemeyeceği yaratıcı senaryolar veya diyaloglar için idealdir. Ses, görüntü veya video üretmez; TTS pipeline'ınızın işleyebileceği saf metin üretir. temperature ve max_tokens gibi parametreleri ihtiyaca göre ayarlayabilirsiniz. API, yapılandırılmış veri çıkarma için fonksiyon çağırma desteği sunar ve yanıtlarınızı uygulamanız için biçimlendirmenize olanak tanır.

Copycurl https://api.ttsapihub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK Entegrasyonu

Python geliştiricileri için resmi openai SDK'sı, minimum yapılandırma ile çalışır. İstemciyi temel URL'niz ve API anahtarınızla başlatın, ardından chat.completions.create() fonksiyonunu çağırın. Bu yaklaşım, mevcut OpenAI uyumlu istemcilerinizi kullanmanızı ve aynı zamanda sansürsüz modelimizin avantajlarından yararlanmanızı sağlar. Yanıt, oluşturulan metni içerir; bu metni doğrudan konuşma sentezleme motorunuza aktarabilirsiniz. Bu metin tabanlı bir API olduğundan, ses oluşturmayı pipeline'ınızda ayrı olarak yönetmeniz gerektiğini unutmayın.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ttsapihub.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK Entegrasyonu

Node.js geliştiricileri, Python ile aynı yapılandırmayı kullanarak openai npm paketini kullanabilir. baseURL değerini uç noktamıza ayarlayın ve API anahtarınızı girin. Model kimliği uncensored ile tamamlama uç noktasını çağırın. Bu entegrasyon basittir ve metin üretimimizi mevcut Node.js TTS hizmetlerinize doğrudan entegre etmenizi sağlar. API, standart JSON ile yanıt verir; bu da oluşturulan metni uygulamanızın ihtiyaçlarına göre işlemeyi ve ayrıştırmayı kolaylaştırır.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ttsapihub.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

SSE ile Akış Yanıtları

Daha düşük gecikme süresi için isteğinizde stream: true ayarlayarak akış özelliğini etkinleştirin. API, artımlı metin parçaları içeren Sunucu Tarafı Olayları (SSE) döndürür. Bu özellik, uzun formatlı içerik oluştururken özellikle yararlıdır; kullanıcılar metnin gerçek zamanlı olarak belirdiğini görebilir. Akış yanıtı standart OpenAI SSE formatını izler, bu nedenle mevcut akış ayrıştırıcılarını kullanabilirsiniz. Bu yaklaşım algılanan bekleme sürelerini azaltır ve metin oluşturulurken uygulamanızın metni göstermesine olanak tanır; bu da TTS pipeline'ınız için kullanıcı deneyimini iyileştirir.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Limitler, Hatalar ve Bağlam Penceresi

API anahtarınız dakikada 300 istek ve 8 MB istek gövdesi ile sınırlıdır. Model, 100.000 token'lık bir bağlam penceresi destekler; bu da uzun senaryolar veya belgeler için olanak sağlar. Yaygın hatalar arasında 401 (geçersiz anahtar), 402 (yetersiz kredi) ve 429 (hız limiti) yer alır. Hız limitine ulaşırsanız üstel geri çekilme (exponential backoff) uygulayın. Fiyatlandırma şeffaftır: 1M girdi token başı $0.25 ve 1M çıktı token başı $1.00. Krediler ön ödemelidir, asla sona ermez ve bakiye yükleme işlemleri $10'dan başlar. Yeni bir hesap, kart gerektirmeden 7 gün boyunca geçerli olan $0.50 ücretsiz deneme kredisi alır. İçerik sınırları yalnızca reşit olmayanları içeren cinsel içeriği engeller; diğer tüm yasal yetişkin, kurgusal veya tartışmalı konulara izin verilir.