دليل البدء السريع لواجهة برمجة تطبيقات TTS

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

ابدأ بتكوين عميلك للإشارة إلى عنوان URL الأساسي الخاص بنا: https://api.ttsapihub.com/v1. واجهة برمجة التطبيقات الخاصة بنا متوافقة تمامًا مع OpenAI، لذا يمكنك استخدام مكتبات SDK القياسية عن طريق تحديث base_url فقط وتوفير مفتاح API الخاص بك. تتم المصادقة عبر رأس Authorization مع رمز حامل. يمكنك إنشاء مفتاح فريد أثناء التسجيل في صفحة الحصول على مفتاح API. كل حساب محدود بمفتاح نشط واحد، يمكنك تجديده في أي وقت. لا تُستخدم موجّهاتك في التدريب، ولا يلزم رقم هاتف أو بطاقة ائتمان للبدء مع الرصيد التجريبي.

توليد النص باستخدام إكمال الدردشة

أرسل طلب POST /v1/chat/completions قياسي لتوليد النص. معرف النموذج المستخدم هو uncensored. هذا النموذج هو نموذج LLM مفتوح الأوزان مضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، مما يجعله مثاليًا لسيناريوهات الإبداع أو الحوار حيث قد تحجب الفلاتر المؤسسية محتواك. لا يولد الصوت أو الصور أو الفيديو؛ بل ينتج نصًا خالصًا لمعالجته بواسطة خط أنابيب TTS الخاص بك. يمكنك ضبط المعلمات مثل temperature و max_tokens حسب الحاجة. تدعم واجهة برمجة التطبيقات استدعاء الدوال لاستخراج البيانات المهيكلة، مما يتيح لك تنسيق الاستponses لتطبيقك.

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": "Write a blunt product review of a cheap VPN."}]
  }'

تكامل SDK لـ Python

لمطوري Python، تعمل مكتبة SDK الرسمية openai بشكل مباشر مع الحد الأدنى من التكوين. قم بتهيئة العميل باستخدام عنوان URL الأساسي ومفتاح API، ثم قم باستدعاء chat.completions.create(). يتيح لك هذا النهج الاستفادة من العملاء المتوافقين مع OpenAI مع الاستفادة من نموذجنا بدون رقابة. تتضمن الاستجابة النص المولد، والذي يمكنك تغذيته مباشرة في محرك تركيب الكلام الخاص بك. تذكر أن هذه واجهة نصية فقط، لذا فإنك تتعامل مع توليد الصوت بشكل منفصل في خط الأنابيب الخاص بك.

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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

تكامل SDK لـ Node

يمكن لمطوري Node.js استخدام حزمة npm openai بنفس تكوين Python. اضبط baseURL على نقطة النهاية الخاصة بنا وقم بتوفير مفتاح API الخاص بك. قم باستدعاء نقطة نهاية الإكمال بمعرف النموذج uncensored. هذا التكامل مباشر ويسمح لك بدمج توليد النص الخاص بنا مباشرة في خدمات TTS لـ Node.js الحالية. تستجيب الواجهة بـ JSON قياسي، مما يسهل تحليل ومعالجة النص المولد لاحتياجات تطبيقك.

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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

استجابات البث المتدفق عبر SSE

لتقليل زمن الوصول، فعّل البث عن طريق تعيين stream: true في طلبك. تعيد الواجهة أحداث المخدم المرسلة (SSE) التي تحتوي على أجزاء نصية متزايدة. هذا مفيد بشكل خاص لتوليد المحتوى طويل المدى، حيث يمكن للمستخدمين رؤية النص يظهر في الوقت الفعلي. تتبع استجابة البث تنسيق SSE القياسي لـ OpenAI، لذا يمكنك استخدام محللي التدفق الموجودين. يقلل هذا النهج من أوقات الانتظار المتصورة ويسمح لتطبيقك بعرض النص أثناء توليده، مما يحسن تجربة المستخدم لخط أنابيب TTS الخاص بك.

Copystream = 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 MB. يدعم النموذج نافذة سياق بحجم 100,000 رمز، مما يتيح كتابة نصوص أو مستندات طويلة. تشمل الأخطاء الشائعة: 401 (مفتاح غير صالح)، 402 (عدم كفاية الرصيد)، و429 (حدّ المعدل). إذا وصلت إلى حدّ المعدل، فعّل آلية التخلف الأسي. الأسعار شفافة: $0.25 لكل مليون رمز مدخل و$1.00 لكل مليون رمز مخرج. الأرصدة مسبق الدفع، لا تنتهي صلاحيتها أبداً، وتبدأ شحنات الرصيد من $10. يحصل الحساب الجديد على $0.50 كرصيد تجريبي مجاني صالح لمدة 7 أيام، دون الحاجة إلى بطاقة. حدود المحتوى تحجب فقط المحتوى الجنسي الذي يتضمن قاصرين؛ جميع المواضيع الأخرى القانونية للبالغين، أو الخيالية، أو المثيرة للجدل مسموحة.