Xtts pipeline'ları için hızlı başlangıç

Kimlik Doğrulama & Base URL

API anahtarını al sayfasına giderek Google veya e-posta şifresi ile giriş yapın. Size özel bir API anahtarı hemen verilecektir. Tüm istekler için https://api.xtts.cc/v1 base URL'ini kullanın. Bu URL, resmi OpenAI SDK'larına ve OpenAI chat-completions formatını destekleyen herhangi bir istemciye uyumludur.

Anahtarınızı Authorization başlığına bir bearer token olarak ekleyin. Göndermeniz gereken model tanımlayıcısı uncensored'dir. Bu açık ağırlıklı model sunucularımızda barındırılır ve yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır; böylece ses akışınız, ihtiyacı olan ham metni alır.

Sansürsüz Metin Oluştur

Sistem ve kullanıcı istemlerinizi içeren bir POST isteğini /v1/chat/completions uç noktasına gönderin. API, oluşturulan metni içeren yapılandırılmış bir JSON döndürür. Bu uç nokta, ses klonlama iş akışınızdaki istem yazımı, betik oluşturma ve post-işleme görevleri için tasarlanmıştır.

İstek gövdesi model adını, mesaj geçmişinizi ve sıcaklık veya top_p gibi isteğe bağlı parametreleri içerir. Çıktı uzunluğunu max_tokens parametresi ile kontrol edebilirsiniz. max_tokens ayarlanmazsa, yanıt pencerenin sonuna kadar uzayabilir.

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

Python SDK Entegrasyonu

API'mizle etkileşim kurmak için resmi OpenAI Python SDK'sını kullanın. base_url değerini uç noktamıza ayarlayın ve API anahtarınızı sağlayın. Bu yaklaşım, mevcut kod yapılarından yararlanırken sansürsüz modelimizin davranışlarından faydalanmanızı sağlar.

Base URL ile bir istemci örneği oluşturun ve ardından chat.completions.create'i çağırın. uncensored model kimliğini ve mesajlarınızı iletin. Yanıt nesnesi, oluşturulan metni content içinde içerir. Bu yöntem, toplu işleme betikleri veya metin üretimi için büyük Python uygulamalarına entegrasyon için idealdir.

Kopyalafrom 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)

Node SDK Entegrasyonu

JavaScript ortamları için OpenAI Node SDK'sını kullanın. İstemciyi base URL ve API anahtarımızla yapılandırın. Bu kurulum, web veya sunucu tarafı uygulamalarınızda doğrudan metin oluşturmanızı sağlar.

Chat completions uç noktasını uncensored modeliyle çağırın. Yanıt, oluşturulan metni sağlar; bu metni daha sonra ses sentezleme motorunuza iletebilirsiniz. Bu entegrasyon, web uygulamalarında gerçek zamanlı metin üretimi veya ses klonlama için betikler hazırlayan arka uç hizmetleri için uygundur.

Kopyalaimport 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);

Akışlı Yanıtlar

İsteğinizde stream değerini true olarak ayarlayarak akışı etkinleştirin. API, her oluşturulan token için Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Bu özellik, gerçek zamanlı metin gösterimi veya aşamalı ses sentezleme hazırlığı için kullanışlıdır.

Her olay parçası kısmi metin içerir. Son parça token sayıları gibi kullanım istatistiklerini içerir. Akış, uygulamanızın metni oluşturulurken işleyebilmesini sağlayarak kullanıcılar için algılanan gecikmeyi azaltır. Tam yanıtı biriktirmek için akış olaylarını işleyin.

Kopyalastream = 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)

Hız Limitleri & Parametreler

Her API anahtarı dakikada 300 istek ve 8 eşzamanlı istekle sınırlıdır. İstek gövdesi 8 MB'ı aşmamalıdır. Geçersiz bir anahtar gönderirseniz 401 hatası alırsınız. Ön ödemeli krediniz tükendiğinde 402 hatası alırsınız. Hız limitini aşmak 429 hatasına neden olur.

Bağlam penceresi, hem istemi hem de tamamlamayı dahil olmak üzere toplam 100.000 tokenı destekler. Ayrı bir çıktı sınırı yoktur ve daha kısa bir yanıt istiyorsanız daha düşük bir max_tokens belirtebilirsiniz. Hatalar ve reddiye tokenları ön ödemeli kredinizi tüketmez. Yapılandırılmış veri çıkarma için fonksiyon çağırma ve JSON modu desteği mevcuttur.