البدء السريع لخطوط أنابيب Whisper

المتطلبات المسبقة

قبل البدء، تأكد من امتلاكك لحساب نشط ومفتاح API. سجّل في صفحة الحصول على مفتاح API باستخدام بريدك الإلكتروني وكلمة المرور فقط. يظهر المفتاح فورًا. تتلقى رصيدًا تجريبيًا بقيمة $0.50 صالح لمدة 7 أيام، دون الحاجة إلى بطاقة ائتمان. للإنتاج، قم بشحن الرصيد من $10 عبر العملات المشفرة (USDT أو USDC). أسعارنا مباشرة: $0.25 لكل مليون رمز مدخل و $1.00 لكل مليون رمز مخرج. لا تنتهي صلاحية الرصيد.

عنوان URL الأساسي: https://api.whisperapis.com/v1. تعمل نقطة النهاية هذه مع أي عميل متوافق مع OpenAI. تحتاج فقط إلى تكوين عنوان URL الأساسي وتوفير مفتاح API الخاص بك في رأس المصادقة. لا توجد حاجة إلى مكتبات SDK خاصة للطلبات الأساسية عبر HTTP.

تهيئة العميل

سيعتمد معظم المطورين على مكتبة OpenAI SDK الرسمية أو مكتبة متوافقة. قم بتهيئة العميل بتوجيهه إلى عنوان URL الأساسي الخاص بنا. يضمن ذلك توجيه جميع الطلبات إلى نموذجنا غير الخاضع للرقابة بدلاً من خوادم OpenAI. معرف النموذج هو دائمًا uncensored.

تأكد من أن متغير البيئة OPENAI_API_KEY مضبوطًا على مفتاحك من لوحة التحكم. إذا كنت تستخدم لغة أو مكتبة مختلفة، تحقق من دعمها لعناوين URL الأساسية المخصصة. تتولى مكتبة SDK تجزئة JSON وإدراج الرؤوس نيابةً عنك، مما يقلل من الكود المكرر في نصوص خط الأنابيب الخاص بك.

إرسال إكمال المحادثة

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

نقطة النهاية هي POST /v1/chat/completions. قم بتضمين معرف النموذج، ومصفوفة الرسائل الخاصة بك، وموجه النظام الاختياري لتحديد سلوك النموذج غير الخاضع للرقابة.

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

يتعامل نموذجنا مع البيانات عالية السياق بشكل جيد، ويدعم ما يصل إلى 100,000 رمز إجماليًا. هذا مثالي لمعالجة النصوص الطويلة أو الأوصاف التفصيلية للصور في عملية واحدة.

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

للمعالجة اللاحقة في الوقت الفعلي أو خطوط الأنابيب التفاعلية، فعّل البث المتدفق. اضبط المعلمة stream على true في طلبك. تعيد الواجهة أحداث SSE بدلاً من كائن JSON واحد.

قم بتحليل حقول delta عند وصولها. يقلل هذا من زمن الاستجابة المدرك للمخرجات الكبيرة، مثل توليد نصوص تفصيلية أو استخراج كتل نصية طويلة من نتائج OCR الضوضائية. تنسيق البث المتدفق متوافق مع معالجات البث المتدفق القياسية في مكتبة OpenAI SDK.

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)

تأكد من أن عميلك يتعامل مع الشظايا الجزئية بشكل صحيح. اجمع القيم الجزئية لإعادة بناء نص الاستجابة الكامل بمجرد انتهاء التدفق بقيمة finish_reason تساوي stop أو length.

دعم استدعاء الدوال

يدعم نموذجنا غير الخاضع للرقابة استدعاء الدوال، مما يتيح لك تحديد مخرجات منظمة لخطوط الأنابيب الخاصة بك. عرّف أدواتك في مصفوفة tools مع تعريفات مخطط JSON.

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

Copyfrom openai import OpenAI

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

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

الحدود والأخطاء والسياق

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

الأخطاء الشائعة:

• 401: مفتاح API غير صالح أو منتهي الصلاحية. أعد إنشاء مفتاحك من لوحة التحكم.
• 402: رصيد غير كافٍ. قم بشحن حسابك للمتابعة في المعالجة.
• 429: تم تجاوز حد المعدل. قلل من وتيرة الطلبات أو قم بتجميع المهام الأصغر.

نافذة السياق: يدعم النموذج 100,000 رمز للموجّه + الإكمال. إذا تجاوزت مدخلاتك هذا الحد، قم بقص الرسائل الأقدم أو قسم البيانات. حدود جسم الطلب هي 8 ميجابايت. تأكد من أن حمولاتك تتناسب مع هذه القيود لأداء موثوق.

Node.js

Copyimport OpenAI from "openai";

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