توثيق API: مكتملات المحادثات لمسارات النصوص

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

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

الطلب الأول

أرسل طلب POST قياسي إلى /v1/chat/completions. معرف النموذج هو دائمًا uncensored. هذا النموذج هو نسخة مفتوحة الأوزان مضبوطة لرفض الحد الأدنى في المواضيع القانونية. يعمل على خوادم GPU المخصصة لدينا. لا تحصل على GPT أو Claude؛ بل تحصل على تجربة نموذج واحد متسقة. يتضمن جسم الطلب علامات model، وmessages، وstream. فيما يلي مثال أساسي لـ cURL للتحقق من الاتصال والحصول على استجابة نصية.

Copycurl https://api.speechtotextapis.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."}]
  }'

يعيد هذا الطلب كائن JSON يحتوي على النص المولد. إذا كان المفتاح غير صالح، تتلقى خطأ 401. إذا استنفدت رصيدك المسبق الدفع، تتلقى خطأ 402. هذه هي العوائق الرئيسية التي يجب التحقق منها قبل تصحيح منطق البرنامج.

تكامل SDK لـ Python

لمطوري Python، تعمل المكتبة الرسمية openai بشكل مباشر. قم بتهيئة العميل بمفتاحك وعنوان URL الأساسي المخصص. مرر معرف النموذج uncensored في استدعاء مكتملات المحادثة. هذا النهج مثالي لمعالجة مخرجات ASR، وتنظيف ضوضاء النسخ، أو استخراج بيانات هيكلية من النص الخام. يضمن الطابع غير الخاضع للرقابة أنه إذا كان لديك نص يحتوي على حوار بالغ أو مصطلحات مثيرة للجدل، فسيتم معالجته بواسطة LLM دون حظر أو إعادة كتابة للأخلاق. هذا أمر حاسم لمسارات الإبداع حيث يكون الالتزام بالمصدر الصوتي هو الأهم. تتعامل واجهة SDK مع الترميز وإعادة المحاولة تلقائيًا.

Copyfrom openai import OpenAI

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

تذكر أن معرف النموذج هو بشكل صارم uncensored. لا تحل محله بـ gpt-4 أو معرّفات عامة أخرى، حيث قد لا يتم توجيهها إلى أوزان النموذج بدون رقابة المحددة لدينا.

تكامل SDK لـ Node.js

يمكن لمطوري Node.js استخدام حزمة npm openai بشكل مشابه. اضبط apiKey وbaseURL في مُنشئ العميل. ثم قم باستدعاء chat.completions.create مع النموذج uncensored. هذا مفيد لبرامج التسميات التوضيحية في الوقت الفعلي أو مهام توليد النص على الخادم. تدعم واجهة الأوامر حمولات JSON القياسية. يمكنك تضمين رسائل النظام لتحديد النبرة أو دور المساعد. يستجيب النموذج بدون رقابة لهذه الموجّهات مباشرة دون طبقات أمان إضافية قد تغير المخرجات الإبداعية. تأكد من معالجة دفق الاستجابة إذا كنت تعالج مستندات كبيرة. تجريد واجهة SDK تفاصيل HTTP، مما يتيح لك التركيز على منطق مسارات النصوص.

Copyimport OpenAI from "openai";

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

تنطبق حدود المعدل لكل مفتاح. إذا تجاوزت 300 طلب في الدقيقة، ستعيد واجهة الأوامر خطأ 429. نفذ استردادًا أسيًا في منطق إعادة المحاولة للتعامل مع هذا بشكل سلس.

استجابات البث المتدفق (SSE)

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

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)

لا يغير البث المتدفق فواتير الرموز. يتم تحميلك عن إجمالي الرموز المدخلة والمخرجة بغض النظر عما إذا كنت تبث أو تطلب استجابة كاملة.

الحدود والقيود

يحتوي حسابك على حد صارم وهو 300 طلب في الدقيقة لكل مفتاح API. لا يمكن أن يتجاوز جسم الطلب 8 ميجابايت. نافذة السياق هي 100,000 رمز، تغطي كلًا من الموجّه والاكتمال. هذا كافٍ لمعالجة معظم المستندات ومهام النسخ طويلة السياق. إذا أرسلت موجّهًا يتجاوز نافذة السياق، ستعيد واجهة الأوامر خطأ. يحجب النموذج بدون رقابة حدًا صارمًا واحدًا فقط: المحتوى الجنسي الذي يتضمن قاصرين. كل المحتوى البالغ القانوني الآخر مسموح به. هذا يجعله مثاليًا لمسارات الوسائط حيث يُتوقع تنوع المحتوى. لا توجد اشتراكات؛ أنت تدفع مقابل ما تستخدمه. لا ينتهي رصيدك المسبق الدفع. استخدم نقطة النهاية GET /v1/models للتحقق من التوفر إذا لزم الأمر، على الرغم من أن معرف النموذج هو دائمًا uncensored.