Panduan Cepat API TTS
Panduan cepat ini menunjukkan cara mengintegrasikan API penyelesaian chat tanpa sensor kami ke dalam pipeline TTS Anda. Gunakan endpoint yang kompatibel dengan OpenAI untuk menghasilkan skrip, caption, dan dialog tanpa penolakan konten.
https://api.ttsapihub.com/v1
URL Dasar dan Autentikasi
Mulailah dengan mengonfigurasi klien Anda untuk menunjuk ke URL dasar kami: https://api.ttsapihub.com/v1. API kami sepenuhnya kompatibel dengan OpenAI, sehingga Anda dapat menggunakan SDK standar hanya dengan memperbarui base_url dan menyediakan kunci API Anda. Autentikasi ditangani melalui header Authorization dengan token Bearer. Anda menghasilkan kunci unik saat pendaftaran di halaman Dapatkan Kunci API. Setiap akun dibatasi hanya untuk satu kunci aktif, yang dapat Anda regenerasi kapan saja. Prompt Anda tidak digunakan untuk pelatihan, dan tidak diperlukan nomor telepon atau kartu kredit untuk memulai dengan kredit uji coba.
Menghasilkan Teks dengan Chat Completions
Kirim permintaan POST /v1/chat/completions standar untuk menghasilkan teks. ID model yang harus digunakan adalah uncensored. Model ini adalah LLM bobot terbuka yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, menjadikannya ideal untuk skrip kreatif atau dialog di mana filter perusahaan mungkin memblokir konten Anda. Model ini tidak menghasilkan audio, gambar, atau video; model ini menghasilkan teks murni untuk diproses oleh pipeline TTS Anda. Anda dapat menyesuaikan parameter seperti temperature dan max_tokens sesuai kebutuhan. API mendukung pemanggilan fungsi untuk ekstraksi data terstruktur, memungkinkan Anda memformat respons untuk aplikasi Anda.
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": "Write a blunt product review of a cheap VPN."}]
}'
Integrasi SDK Python
Untuk pengembang Python, SDK openai resmi berfungsi langsung dengan konfigurasi minimal. Inisialisasi klien dengan URL dasar dan kunci API Anda, lalu panggil chat.completions.create(). Pendekatan ini memungkinkan Anda memanfaatkan klien yang kompatibel dengan OpenAI sambil mendapatkan manfaat dari model tanpa sensor kami. Respons mencakup teks yang dihasilkan, yang dapat Anda masukkan langsung ke mesin sintesis suara Anda. Ingatlah bahwa ini adalah API teks saja, sehingga Anda menangani generasi audio secara terpisah di pipeline Anda.
from 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)
Integrasi SDK Node.js
Pengembang Node.js dapat menggunakan paket npm openai dengan konfigurasi yang sama seperti Python. Atur baseURL ke endpoint kami dan berikan kunci API Anda. Panggil endpoint completions dengan ID model uncensored. Integrasi ini sederhana dan memungkinkan Anda mengintegrasikan generasi teks kami langsung ke layanan TTS Node.js yang ada. API merespons dengan JSON standar, sehingga mudah untuk mengurai dan memproses teks yang dihasilkan untuk kebutuhan aplikasi Anda.
import 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);
Respons Streaming via SSE
Untuk latensi lebih rendah, aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE) yang berisi potongan teks inkremental. Hal ini sangat berguna untuk generasi konten panjang, karena pengguna dapat melihat teks muncul secara real-time. Respons streaming mengikuti format SSE OpenAI standar, sehingga Anda dapat menggunakan parser stream yang ada. Pendekatan ini mengurangi waktu tunggu yang dirasakan dan memungkinkan aplikasi Anda menampilkan teks saat teks tersebut dihasilkan, meningkatkan pengalaman pengguna untuk pipeline TTS Anda.
stream = 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)
Batas, Kesalahan, dan Jendela Konteks
Kunci API Anda dibatasi menjadi 300 permintaan per menit dan tubuh permintaan 8 MB. Model ini mendukung jendela konteks 100.000 token, memungkinkan skrip atau dokumen panjang. Kesalahan umum termasuk 401 (kunci tidak valid), 402 (saldo tidak cukup), dan 429 (batas laju). Jika Anda mencapai batas laju, terapkan backoff eksponensial. Harga transparan: $0,25 per 1M token input dan $1,00 per 1M token output. Saldo prabayar, tidak pernah kedaluwarsa, dan isi saldo dimulai dari $10. Akun baru menerima $0,50 kredit uji coba gratis yang berlaku selama 7 hari, tanpa memerlukan kartu. Batasan konten hanya memblokir konten seksual yang melibatkan minor; semua topik dewasa, fiksi, atau kontroversial lainnya yang sah diperbolehkan.
Spesifikasi teknis
Semua batas dan fitur API yang sebenarnya di satu tempat — cek dulu sebelum isi saldo.
| Item | Nilai |
|---|---|
| Format | kompatibel OpenAI: SDK OpenAI apa pun bisa dipakai, cukup ganti base URL dan kunci |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| ID model | uncensored |
| Autentikasi | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.ttsapihub.com/v1 |
| Jendela konteks | 100.000 token (input + output) |
| Streaming | ya — server-sent events; potongan terakhir berisi penggunaan token |
| Mode JSON | response_format: {"type": "json_object"} |
| Parameter | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Function calling | ya — tools, tool_choice; balasan berisi tool_calls, juga saat streaming; hasil dikirim sebagai role: tool |
| Output maksimal | hingga sisa jendela 100.000 token; max_tokens opsional (tanpa batas terpisah) |
| Header respons | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Konkurensi | 8 permintaan bersamaan per kunci |
| Ukuran permintaan | hingga 8 MB |
| Batas laju | 300 permintaan per menit per kunci |
| Penagihan | saldo prabayar sesuai pemakaian nyata; error dan penolakan gratis |
| Bonus | +5% mulai $50, +10% mulai $100 |
| Harga | $0,25 per 1 juta token input · $1,00 per 1 juta token output |
| Isi saldo | USDT (TRC20) atau USDC (Base), nominal bulat berapa pun dari $10 sampai $500 |
| Masa berlaku | saldo berbayar tidak kedaluwarsa, tanpa langganan |
| Uji coba gratis | $0,50 selama 7 hari, tanpa kartu · Kunci uji coba: 2 permintaan paralel, 60 per menit; batas penuh (8 dan 300) setelah isi saldo pertama |
| Konten | konten dewasa diizinkan; konten seksual yang melibatkan anak di bawah umur ditolak |
| Kunci | satu kunci aktif per akun; kunci baru menggantikan yang lama |
| Masuk | Google atau email dan kata sandi |
Kode error
Error dikirim sebagai JSON dengan type tetap; permintaan gagal atau ditolak tidak ditagih.
| Kode | Tipe | Arti |
|---|---|---|
400 | bad_request | JSON tidak valid, pesan kosong, parameter salah, atau konteks terlalu panjang |
401 | missing_key · invalid_key · key_revoked | kunci tidak ada, salah, atau sudah diganti |
402 | no_credit | saldo habis — isi ulang dan lanjut seketika |
403 | content_blocked | konten seksual dengan anak di bawah umur — ditolak, tidak ditagih |
404 | not_found | endpoint tidak dikenal |
413 | request_too_large | body lebih dari 8 MB |
429 | rate_limited · concurrency | lebih dari 300/menit atau 8 paralel — tunggu lalu coba lagi |
503 | upstream_busy | model sibuk — coba lagi beberapa detik lagi |
Tanya jawab
Apakah API ini menghasilkan audio?
Tidak, ini adalah API teks saja. API ini menghasilkan skrip teks atau dialog, yang kemudian Anda kirimkan ke mesin TTS terpisah untuk menghasilkan audio. API ini tidak menghasilkan file audio, gambar, atau video.
Bagaimana cara memulai dengan API ini?
Daftar di halaman Dapatkan Kunci API dengan email dan kata sandi. Anda menerima kunci API segera dan $0,50 dalam kredit uji coba yang berlaku selama 7 hari. Tidak diperlukan kartu kredit atau nomor telepon untuk memulai.
Berapa ukuran jendela konteks?
Model ini mendukung jendela konteks 100.000 token, yang mencakup baik prompt input maupun kelengkapan output. Hal ini memungkinkan pemrosesan dokumen panjang atau mempertahankan riwayat percakapan yang luas dalam pipeline Anda.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kuncinya, ubah URL dasar. Itu saja seluruh pengaturannya.