URL Dasar API TTS: Apa Itu dan Apa yang Harus Dimasukkan

URL dasar, dan satu hal yang perlu diketahui pertama kali

Jika Anda sampai di sini dengan mencari tts api base url, periksa satu detail sebelum Anda menyalin apa pun: layanan di balik situs ini adalah API model bahasa teks, bukan synthesizer suara. URL dasar adalah https://api.ttsapihub.com/v1, dan ini mengekspos POST /v1/chat/completions serta GET /v1/models. Tidak ada rute /audio/speech, tidak ada daftar suara, dan tidak ada output audio.

Hal ini penting karena banyak alat menamai pengaturan mereka secara generik. Bidang base URL di klien bekerja dengan cara yang sama apakah server di baliknya merespons dengan teks atau suara. Jika tujuan Anda adalah mengubah teks menjadi audio, endpoint ini tidak akan melakukannya. Jika tujuan Anda adalah menghasilkan teks yang akan dibaca oleh alat suara nanti, untuk naskah, dialog, atau draf narasi, ini sangat cocok. daftar periksa pipeline TTS di situs adalah tempat yang tepat untuk dilihat saat Anda merencanakan alur kerja semacam itu, dan dokumen quickstart mencantumkan setiap parameter permintaan.

Sisa halaman ini berlaku untuk klien yang kompatibel dengan OpenAI, sehingga berguna bahkan jika Anda hanya di sini untuk mempelajari cara kerja URL dasar.

Apa sebenarnya URL dasar

Alamat API memiliki dua bagian. Bagian pertama mengidentifikasi layanan dan versi antarmukanya. Bagian kedua menamai tindakan. Pustaka klien menggabungkannya untuk Anda. Dengan SDK OpenAI, bagiannya terlihat seperti ini:

Bagian	Nilai
URL dasar	https://api.ttsapihub.com/v1
Jalur ditambahkan oleh SDK untuk obrolan	/chat/completions
Alamat lengkap yang dipanggil	https://api.ttsapihub.com/v1/chat/completions
Jalur untuk daftar model	/models

Karena SDK menambahkan jalur, Anda memberikannya hanya bagian pertama. Itulah seluruh ide di balik mengganti penyedia dengan perubahan satu baris: format permintaan bersifat bersama, sehingga satu-satunya hal yang harus dipindahkan adalah tempat permintaan dikirim. Kuncinya juga berubah, karena setiap layanan menerbitkan kuncinya sendiri. Dan nama model berubah, karena setiap layanan menamai modelnya sendiri. Untuk API ini, ID model adalah uncensored.

Dua detail kecil menghemat waktu. Segmen versi, /v1, milik URL dasar karena menandai generasi antarmuka; antarmuka yang tidak kompatibel di masa depan akan berada di bawah versi yang berbeda, dan kode Anda tidak akan berubah sampai Anda memilih untuk pindah. Dan garis miring akhir pada URL dasar ditoleransi oleh sebagian besar SDK, tetapi lebih aman untuk tidak menyertakannya agar jalur yang digabungkan tidak pernah mengandung garis miring ganda.

Autentikasi adalah header bearer standar: Authorization: Bearer YOUR_KEY. SDK membangun header tersebut dari kunci yang Anda berikan, sehingga Anda jarang menuliskannya sendiri kecuali di curl.

Mengatur URL dasar dalam kode

Python

Paket openai resmi mengambil argumen base_url. Ini adalah panggilan kerja penuh:

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

Dengan curl, Anda menulis alamat lengkap sendiri, sehingga jalur disertakan:

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

Variabel lingkungan

Versi terbaru dari SDK OpenAI resmi membaca OPENAI_BASE_URL dan OPENAI_API_KEY dari lingkungan saat Anda tidak meneruskannya dalam kode. Itu sangat membantu saat Anda ingin mengarahkan perangkat lunak yang ada ke endpoint baru tanpa mengeditnya. Tetapkan dalam shell atau manajer proses Anda, lalu jalankan program seperti biasa. Periksa dokumentasi versi SDK Anda jika tidak terbaca.

Mengaturnya di editor dan aplikasi

Alat yang menerima endpoint OpenAI kustom meminta tiga nilai yang sama. Nama berbeda, jadi carilah kata-kata seperti berikut:

• Cursor: di pengaturan model ada opsi untuk mengganti URL dasar OpenAI. Tempelkan https://api.ttsapihub.com/v1, tambahkan kunci Anda, dan tambahkan uncensored sebagai nama model kustom. Label antarmuka berubah antar versi Cursor, jadi perlakukan nama-nama ini sebagai panduan.
• SillyTavern: pilih Chat Completion, lalu sumber Kustom (kompatibel OpenAI), dan isi endpoint, kunci, dan model.
• Open WebUI dan antarmuka obrolan serupa: tambahkan koneksi tipe OpenAI dengan URL dasar dan kunci.
• Skrip Anda sendiri: klien HTTP apa pun berfungsi, karena antarmukanya adalah JSON biasa di atas HTTPS.

Beberapa alat memeriksa koneksi dengan memanggil GET /v1/models. API ini mendukung rute tersebut, sehingga pemeriksaan berhasil. Beberapa alat hanya memungkinkan Anda memilih dari daftar tetap; jika milik Anda melakukannya, carilah bidang model kustom atau manual daripada menu dropdown.

Ingatlah apa fungsi alat tersebut. Editor seperti Cursor akan mengirimkan pertanyaan kode ke model obrolan umum, yang berfungsi. Namun fitur yang bergantung pada endpoint khusus, seperti embeddings untuk pencarian kode, tidak tersedia di sini, karena embeddings tidak ditawarkan.

Kesalahan yang menyebabkan sebagian besar kesalahan URL dasar

Hampir setiap koneksi pertama yang gagal berasal dari salah satu dari ini.

1. Menggandakan versi. URL dasar sudah berakhir dengan /v1. Jika Anda menambahkan yang lain, alamat menjadi /v1/v1/chat/completions dan server menjawab dengan kesalahan tidak ditemukan.
2. Menempel jalur lengkap. Bidang base URL menginginkan https://api.ttsapihub.com/v1, bukan https://api.ttsapihub.com/v1/chat/completions. SDK akan menambahkan jalur itu untuk kedua kalinya.
3. Menggunakan alamat situs web. Situs yang Anda baca bukan host API. Permintaan dikirim ke host api. yang ditunjukkan di atas.
4. Memanggil rute suara. Jalur seperti /audio/speech tidak ada di sini dan mengembalikan kesalahan.
5. Nama model salah atau hilang. Selalu kirim uncensored dalam huruf kecil.
6. Masalah kunci. Spasi yang tidak perlu atau awalan Bearer yang hilang di header yang ditulis tangan memberikan kesalahan autentikasi.

Untuk membedakan masalah URL dari masalah kunci, minta daftar model. URL yang benar dan kunci yang salah memberikan kesalahan autentikasi. URL yang salah memberikan tidak ditemukan, kesalahan DNS, atau halaman HTML sebagai pengganti JSON.

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}'

Dapatkan kunci dan biayanya

Anda membutuhkan kunci sebelum semua ini berfungsi. Daftar dengan Google atau dengan email dan kata sandi di halaman kunci API, lalu klaim saldo prabayar uji coba senilai $0,50 dengan satu klik. Ini berlaku selama 7 hari, satu klaim per orang, dan tidak memerlukan kartu. Kunci uji coba memungkinkan 2 permintaan paralel dan 60 permintaan per menit, sementara kunci penuh memungkinkan 8 permintaan paralel dan 300 per menit.

Harga adalah $0,15 per 1M token input dan $0,50 per 1M token output, dibayar dari saldo prabayar tanpa langganan. Permintaan dengan 2.000 token input dan 500 token output berharga $0,0003 ditambah $0,00025, jadi $0,00055. Top-up mulai dari $20 hingga $500 dengan bonus mulai dari $50, dan Anda dapat membayar dengan kartu (Visa, Mastercard, Apple Pay, Google Pay) atau kripto (USDT di TRC20, USDC di Base). halaman harga memiliki tabel lengkap. Prompt tidak digunakan untuk pelatihan, dan model ini hanya untuk penggunaan dewasa yang sah, tanpa konten seksual yang melibatkan anak di bawah umur.

Panduan lainnya

• API Gratis untuk SillyTavern: Kredit Uji Coba dan Pengaturan
• Kunci API TTS di Python: Pengaturan, Streaming, Mode JSON
• Daftar Periksa API Elevenlabs: Pipeline TTS Tanpa Sensor