البدء السريع لخطوط Xtts

المصادقة وعنوان URL الأساسي

ابدأ بالانتقال إلى صفحة الحصول على مفتاح API وتسجيل الدخول باستخدام حساب Google أو كلمة مرور البريد الإلكتروني. ستتلقى مفتاح API فريدًا على الفور. استخدم عنوان URL الأساسي https://api.xtts.cc/v1 لجميع الطلبات. هذا العنوان متوافق مع الـ SDK الرسمية لـ OpenAI وأي عميل يدعم نموذج chat-completions الخاص بـ OpenAI.

أدرج مفتاحك في رأس Authorization كرمز Bearer. معرّف النموذج الذي يجب إرساله هو uncensored. هذا النموذج مفتوح الأوزان مستضاف على خوادمنا ومضبط للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين، مما يضمن أن خط أنابيب الصوت الخاص بك يتلقى النص الخام الذي يحتاجه.

توليد النص بدون رقابة

أرسل طلب POST إلى /v1/chat/completions مع الموجّهات الخاصة بالنظام والمستخدم. تُرجع واجهة برمجة التطبيقات JSON هيكلي يحتوي على النص المُولّد. صُممت نقطة النهاية هذه لكتابة الموجّهات، وتوليد النصوص، ومهام المعالجة اللاحقة في عملية استنساخ الصوت الخاصة بك.

يتضمن جسم الطلب اسم النموذج، وسجل الرسائل الخاص بك، ومعاملات اختيارية مثل temperature أو top_p. يمكنك التحكم في طول الإخراج باستخدام المعامل max_tokens. إذا لم تضبط max_tokens، فقد يمتد الاستجابة إلى نهاية نافذة السياق.

نسخcurl 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."}]
  }'

تكامل SDK Python

استخدم SDK الرسمي لـ Python من OpenAI للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا. اضبط base_url إلى نقطة النهاية الخاصة بنا وقم بتوفير مفتاح API الخاص بك. يتيح لك هذا النهج الاستفادة من هياكل الأكواد الحالية مع الاستفادة من سلوك النموذج بدون رقابة.

أنشئ مثيل عميل باستخدام Base URL ثم استدعي chat.completions.create. مرر معرف النموذج uncensored ورسائلك. يحتوي كائن الاستجابة على النص المُولّد في content. هذه الطريقة مثالية لبرامج معالجة الدفعات أو دمج توليد النص في تطبيقات Python الأكبر حجمًا.

نسخfrom 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)

تكامل SDK Node

لبيئات JavaScript، استخدم مكتبة OpenAI لـ Node. قم بتكوين العميل باستخدام عنوان URL الأساسي ومفتاح API الخاص بنا. يمكّنك هذا الإعداد من توليد النص مباشرة في تطبيقات الويب أو الخوادم الخاصة بك.

استدعي نقطة نهاية إكمال المحادثة مع نموذج uncensored. يوفر الاستجابة النص المُولّد، والذي يمكنك بعد ذلك تمريره إلى محرك توليف الصوت. هذا التكامل مناسب لتوليد النص في الوقت الفعلي في تطبيقات الويب أو خدمات الخلفية التي تعد النصوص لاستنساخ الصوت.

نسخimport 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);

استجابات البث المتدفق

فعّل البث المتدفق عن طريق تعيين stream إلى true في طلبك. تُرجع واجهة برمجة التطبيقات أحداث SSE لكل رمز. هذه الميزة مفيدة لعرض النص في الوقت الفعلي أو التحضير التدريجي لتوليف الصوت.

تحتوي كل قطعة حدث على نص جزئي. تتضمن القطعة الأخيرة إحصائيات الاستخدام، مثل عدد الرموز. يضمن البث معالجة تطبيقك للنص أثناء توليده، مما يقلل من زمن الاستجابة المدرك للمستخدمين. تعامل مع أحداث البث لتراكم الاستجابة الكاملة.

نسخ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)

حدّ المعدل والمعاملات

يقتصر كل مفتاح API على 300 طلب في الدقيقة و8 طلبات متزامنة. يجب ألا يتجاوز جسم الطلب 8 MB. إذا أرسلت مفتاحًا غير صالح، فستحصل على خطأ 401. إذا استنفدت رصيدك المسبق الدفع، فستحصل على خطأ 402. يؤدي تجاوز حدّ المعدل إلى خطأ 429.

تدعم نافذة السياق 100,000 رمز إجماليًا، بما في ذلك كل من الموجّه والإكمال. لا يوجد حد أقصى منفصل للإخراج، ويمكنك تحديد قيمة max_tokens أقل إذا كنت ترغب في رد أقصر. لا تستهلك الأخطاء والرفضات رصيدك المسبق للدفع. دعم استدعاء الدوال ووضع JSON متاح لاستخراج البيانات المهيكلة.