Panduan Cepat untuk Xtts pipelines

Autentikasi & Base URL

Mulai dengan membuka halaman Dapatkan kunci API dan masuk menggunakan Google atau kata sandi email. Anda akan menerima kunci API unik secara instan. Gunakan base URL https://api.xtts.cc/v1 untuk semua permintaan. URL ini kompatibel dengan SDK OpenAI resmi dan klien apa pun yang mendukung format chat-completions OpenAI.

Sertakan kunci Anda di header Authorization sebagai token bearer. Identifier model yang harus Anda kirimkan adalah uncensored. Model bobot terbuka ini di-host di server kami dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah, memastikan voice pipeline Anda menerima teks mentah yang dibutuhkan.

Hasilkan Teks Tanpa Sensor

Kirim permintaan POST ke /v1/chat/completions dengan prompt sistem dan pengguna Anda. API mengembalikan JSON terstruktur yang berisi teks yang dihasilkan. Endpoint ini dirancang untuk penulisan prompt, generasi skrip, dan tugas pasca-pemrosesan dalam workflow voice cloning Anda.

Body permintaan mencakup nama model, riwayat pesan Anda, dan parameter opsional seperti temperature atau top_p. Anda dapat mengontrol panjang output dengan parameter max_tokens. Jika Anda tidak mengatur max_tokens, respons dapat berjalan hingga akhir context window.

Salincurl https://api.xtts.cc/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

Gunakan SDK Python OpenAI resmi untuk berinteraksi dengan API kami. Atur base_url ke endpoint kami dan berikan kunci API Anda. Pendekatan ini memungkinkan Anda memanfaatkan struktur kode yang ada sambil mendapatkan manfaat dari perilaku model tanpa sensor kami.

Buat instance klien dengan base URL dan kemudian panggil chat.completions.create. Lewatkan ID model uncensored dan pesan Anda. Objek respons berisi teks yang dihasilkan di content. Metode ini sangat ideal untuk skrip pemrosesan batch atau mengintegrasikan generasi teks ke dalam aplikasi Python yang lebih besar.

Salinfrom openai import OpenAI

client = OpenAI(base_url="https://api.xtts.cc/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

Untuk lingkungan JavaScript, gunakan SDK Node OpenAI. Konfigurasikan klien dengan base URL dan kunci API kami. Pengaturan ini memungkinkan Anda menghasilkan teks secara langsung di aplikasi web atau sisi server Anda.

Panggil endpoint penyelesaian chat dengan model uncensored. Respons menyediakan teks yang dihasilkan, yang kemudian dapat Anda lewatkan ke mesin voice synthesis Anda. Integrasi ini cocok untuk generasi teks waktu nyata di aplikasi web atau layanan backend yang menyiapkan skrip untuk voice cloning.

Salinimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.xtts.cc/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

Aktifkan streaming dengan mengatur stream menjadi true dalam permintaan Anda. API mengembalikan Server-Sent Events (SSE) untuk setiap token yang dihasilkan. Fitur ini berguna untuk tampilan teks waktu nyata atau persiapan voice synthesis progresif.

Setiap bagian peristiwa berisi teks parsial. Bagian terakhir mencakup statistik penggunaan, seperti jumlah token. Streaming memastikan aplikasi Anda dapat memproses teks saat teks tersebut dihasilkan, mengurangi latensi yang dirasakan bagi pengguna. Tangani peristiwa stream untuk mengumpulkan respons lengkap.

Salinstream = 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 Laju & Parameter

Setiap kunci API dibatasi hingga 300 permintaan per menit dan 8 permintaan paralel. Badan permintaan tidak boleh melebihi 8 MB. Jika Anda mengirimkan kunci yang tidak valid, Anda akan menerima error 401. Jika saldo prabayar Anda habis, Anda akan menerima error 402. Melebihi batas laju akan menghasilkan error 429.

Jendela konteks mendukung total 100,000 token, termasuk prompt dan completion. Tidak ada batas output terpisah, dan Anda dapat menentukan max_tokens yang lebih rendah jika menginginkan balasan yang lebih pendek. Error dan penolakan tidak mengonsumsi saldo prabayar Anda. Dukungan untuk pemanggilan fungsi dan mode JSON tersedia untuk ekstraksi data terstruktur.