TTS API Base URL: Nedir ve Ne Girilmeli

Base URL ve öncelikle bilmeniz gereken bir şey

Bir tts api base url araması yaparak buraya geldiyseniz, bir şeyi kopyalamadan önce bir detayı kontrol edin: bu sitenin arkasındaki hizmet bir ses sentezleyici değil, bir metin dil modeli API'sidir. Base URL https://api.ttsapihub.com/v1'dir ve POST /v1/chat/completions ile GET /v1/models'i açığa çıkarır. /audio/speech rotası, ses listesi veya ses çıktısı yoktur.

Bu önemlidir çünkü birçok araç ayarlarını genel olarak etiketler. Bir istemcide base URL olarak adlandırılan bir alan, arkasındaki sunucu metin mi yoksa ses mi döndürürse döndürsün aynı şekilde çalışır. Hedefiniz metni sese dönüştürmekse, bu uç nokta bunu yapmaz. Hedefiniz bir konuşma aracının daha sonra okuyacağı metni oluşturmaksa (betler, diyaloglar veya anlatım taslakları için), bu uç nokta iyi bir seçimdir. Bu tür bir iş akışını planlarken bakmanız gereken yer TTS pipeline kontrol listesidir ve hızlı başlangıç dokümantasyonu her istek parametresini listeler.

Bu sayfanın geri kalanı herhangi bir OpenAI uyumlu istemci için geçerlidir, bu nedenle base URL'lerin nasıl çalıştığını öğrenmek için burada olmasanız bile faydalıdır.

Base URL aslında nedir

Bir API adresinin iki yarısı vardır. İlk yarı hizmeti ve arayüzünün sürümünü tanımlar. İkinci yarı eylemi adlandırır. İstemci kütüphanesi bunları sizin için birleştirir. OpenAI SDK'ları ile parçalar şöyle görünür:

Parça	Değer
Temel URL	https://api.ttsapihub.com/v1
Sohbet için SDK tarafından eklenen yol	/chat/completions
Çağrılan tam adres	https://api.ttsapihub.com/v1/chat/completions
Model listesi için yol	/models

SDK yolu eklediği için, yalnızca ilk yarısını verirsiniz. Sağlayıcıları tek satırlık bir değişiklikle değiştirmenin arkasındaki fikir budur: istek formatı paylaşıldığından, taşınması gereken tek şey isteklerin gönderildiği yerdir. Anahtar da değişir, çünkü her hizmet kendi anahtarını verir. Ve model adı değişir, çünkü her hizmet kendi modellerine ad verir. Bu API için model ID'si uncensored'dir.

İki küçük ayrıntı zaman kazandırır. Sürüm segmenti, /v1, temel URL'ye aittir çünkü arayüz neslini işaretler; gelecekteki uyumsuz bir arayüz farklı bir sürüm altında yer alacak ve kodunuz taşımaya karar verene kadar değişmez. Ve temel URL'deki son eğik çizgi çoğu SDK tarafından tolere edilir, ancak birleşik yolların çift eğik çizgi içermemesi için onu eklememek daha güvenlidir.

Kimlik doğrulama standart bir bearer başlığıdır: Authorization: Bearer YOUR_KEY. SDK'lar, bu başlığı verdiğiniz anahtardan oluşturur, bu nedenle nadiren kendiniz yazarsınız, curl hariç.

Kodda temel URL ayarlama

Python

Resmi openai paketi bir base_url argümanı alır. Bu tam çalışan bir çağrıdır:

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": "Write a two-line scene opening."}],
)
print(resp.choices[0].message.content)

Node

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: "Write a two-line scene opening." }],
});
console.log(resp.choices[0].message.content);

curl

curl ile tam adresi kendiniz yazarsınız, bu nedenle yol dahildir:

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": "Say hello."}]}'

Ortam değişkenleri

Resmi OpenAI SDK'larının güncel sürümleri, bunları kodda geçmediğinizde OPENAI_BASE_URL ve OPENAI_API_KEY'i ortamdan okur. Mevcut yazılımı düzenlemeden yeni bir uç noktaya yönlendirmek istediğinizde bu kullanışlıdır. Bunları kabuğunuza veya işlem yöneticinize ayarlayın, ardından programı her zamanki gibi çalıştırın. SDK sürümünüzün belgelerine bakın, bunları almıyorsa.

Editörlerde ve uygulamalarda ayarlama

Özel bir OpenAI uç noktası kabul eden araçlar aynı üç değeri ister. İsimler farklılık gösterir, bu nedenle aşağıdaki gibi ifadeleri arayın:

• Cursor: model ayarlarında OpenAI temel URL'sini geçersiz kılma seçeneği vardır. https://api.ttsapihub.com/v1 yapıştırın, anahtarınızı ekleyin ve özel model adı olarak uncensored ekleyin. Arayüz etiketleri Cursor sürümleri arasında değişir, bu nedenle bu isimleri bir rehber olarak kullanın.
• SillyTavern: Chat Completion'u seçin, ardından Özel (OpenAI uyumlu) kaynağı ve uç nokta, anahtar ve modeli doldurun.
• Open WebUI ve benzeri sohbet arayüzleri: temel URL ve anahtar ile bir OpenAI tipi bağlantı ekleyin.
• Kendi betikleriniz: arayüz HTTPS üzerinden ham JSON olduğu için herhangi bir HTTP istemcisi çalışır.

Bazı araçlar bağlantıyı GET /v1/models çağırarak kontrol eder. Bu API bu rotayı destekler, bu nedenle kontrol geçer. Bazı araçlar yalnızca sabit bir listeden seçmenize izin verir; sizin de öyleyse, açılır menü yerine özel veya manuel model alanını arayın.

Aracın ne için olduğunu hatırlayın. Cursor gibi bir editör, genel bir sohbet modeline kod soruları gönderecektir, bu çalışır. Ancak kod araması için gömlemeler gibi özel uç noktalara bağlı özellikler burada mevcut değildir, çünkü gömlemeler sunulmaz.

Çoğu base URL hatasına neden olan hatalar

Başarısız ilk bağlantıların neredeyse hepsi bunlardan birinden kaynaklanır.

1. Sürümün iki kez eklenmesi. Temel URL zaten /v1 ile biter. Başka bir tane daha eklerseniz, adres /v1/v1/chat/completions olur ve sunucu bulunamadı hatası döndürür.
2. Tam yolun yapıştırılması. Bir base URL alanı https://api.ttsapihub.com/v1 ister, https://api.ttsapihub.com/v1/chat/completions değil. SDK yolu ikinci kez eklerdi.
3. Web sitesi adresinin kullanılması. Okuduğunuz site API host'u değildir. İstekler yukarıda gösterilen api. host'una gider.
4. Bir konuşma uç noktasına istek gönderme. /audio/speech gibi yollar burada mevcut değildir ve hata döndürür.
5. Yanlış veya eksik model adı. Her zaman küçük harfle uncensored gönderin.
6. Anahtar sorunları. El ile yazılmış bir başlıkta boşluk veya eksik Bearer ön eki kimlik doğrulama hatasına yol açar.

Bir URL sorununu bir anahtar sorunundan ayırt etmek için model listesini isteyin. Doğru URL ve yanlış anahtar bir kimlik doğrulama hatası verir. Yanlış URL bulunamadı hatası, DNS hatası veya JSON yerine HTML sayfası döndürür.

Copycurl https://api.ttsapihub.com/v1/models -H "Authorization: Bearer $API_KEY"
# then a minimal chat call with the model ID "uncensored":
curl https://api.ttsapihub.com/v1/chat/completions -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

Anahtar alın ve neye mal olduğu

Bunun çalışması için bir anahtara ihtiyacınız var. API anahtarı sayfası üzerinden Google veya e-posta ve şifre ile kaydolun, ardından tek tıkla $0.50 deneme kredisi talep edin. 7 gün boyunca geçerlidir, kişi başı bir talep hakkı vardır ve kart gerektirmez. Deneme anahtarı 2 eşzamanlı istek ve dakika başına 60 istek izni verir; tam anahtar ise 8 eşzamanlı ve dakika başına 300 istek izni verir.

Fiyatlandırma 1M input token başına $0.15 ve 1M output token başına $0.50 olup, ön ödemeli krediden ve abonelik olmadan ödenir. 2.000 input token ve 500 output token içeren bir istek $0.0003 artı $0.00025, yani $0.00055 tutarındadır. Bakiye yükleme $20 ile $500 arasında değişir ve $50'den başlayan bonuslar sunulur; kart (Visa, Mastercard, Apple Pay, Google Pay) veya kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile ödeme yapabilirsiniz. Fiyatlandırma sayfası tam tabloyu içerir. İstemler eğitim için kullanılmaz ve model yalnızca yasal yetişkin kullanımı içindir; reşit olmayanlar içeren cinsel içerik barındırmaz.

Daha fazla kılavuz

• SillyTavern için Ücretsiz API: Deneme Kredisi ve Kurulum
• Python'da TTS API Anahtarı: Kurulum, Akış, JSON Modu
• Elevenlabs API Checklist: Sansürsüz TTS Pipeline