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

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

قبل الدمج، تأكد من امتلاكك لحساب نشط. سجّل عبر Google أو البريد الإلكتروني في صفحة الحصول على مفتاح API لتلقي مفتاحك الفوري فوراً. لا تحتاج إلى بطاقة ائتمان للتجربة الأولية بقيمة $0.50. يقدم نموذج LLM بدون رقابة معرف النموذج "uncensored" عبر نقطة نهاية قياسية. عنوان URL الأساسي هو https://api.vibevoice.top/v1.. هذا الإعداد يعمل مع أي حزمة SDK من OpenAI، مما يجعله بديلاً جاهزاً للعديد من خطوط الأنابيب الحالية.

المصادقة

مرّر مفتاح API الخاص بك في رأس المصادقة. يجب أن يكون التنسيق "Bearer YOUR_API_KEY". إذا كان المفتاح مفقوداً أو غير صالح، تُرجع واجهة برمجة التطبيقات خطأ 401. نظراً لأننا نركز على معالجة النصوص، تأكد من أن خط الأنابيب الخاص بك يرسل بيانات نصية فقط. المفتاح مرتبط بحساب واحد؛ استبدال المفتاح القديم يتم فوراً عند إنشاء مفتاح جديد. يسمح هذا البساطة بالتكرار السريع في بيئة التطوير الخاصة بك.

إرسال طلب

أرسل طلب POST إلى /v1/chat/completions. قم بتضمين معرف النموذج ورسائلك وأي معاملات. إليك مثال أساسي باستخدام cURL:

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

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

دمج حزمة SDK لـ Python

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.vibevoice.top/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، استخدم حزمة npm openai. قم بتعيين خصائص apiKey وbaseURL في كائن التكوين. هذا يضمن أن الطلبات تذهب إلى نقطة النهاية الصحيحة. تدعم حزمة SDK لـ Node نفس المعاملات كما في النسخة Python. إنها مثالية لخوادم الويب أو الوظائف الطرفية التي تحتاج إلى توليد النص عند الطلب.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.vibevoice.top/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 في طلبك. ترجع واجهة برمجة API البيانات في أجزاء كما يتم توليدها. هذا مفيد للعرض في الوقت الفعلي أو عرض النص التدريجي. تتضمن الشريحة الأخيرة إحصائيات استخدام الرموز الكاملة. يقلل البث المتدفق من زمن الاستجابة المدرك للمستخدمين النهائيين.

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)

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