توثيق واجهة Uncensored Video API للأدوات

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

تستخدم API نقطة النهاية الأساسية القياسية المتوافقة مع OpenAI. أرسل الطلبات إلى https://api.uncensoredvideo.top/v1. تعتمد المصادقة على مفتاح API واحد يتم إنشاؤه أثناء تسجيل الحساب. أضفه في رأس Authorization كرمز Bearer. تحصل الحسابات الجديدة على مفتاح فوري عبر تسجيل الدخول عبر Google أو التسجيل بالبريد الإلكتروني. لا يلزم رقم الهاتف. يبقى المفتاح نشطًا حتى استبداله يدوياً؛ الرصيد المسبق الدفع لا ينتهي.

الطلب الأول

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

نسخcurl https://api.uncensoredvideo.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."}]
  }'

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

تكامل SDK لـ Python

استخدم حزمة SDK الرسمية لـ Python من OpenAI. اضبط base_url و api_key لتتوافق مع نقاط نهاية واجهة الفيديو بدون رقابة. يتيح لك ذلك استخدام الأساليب المألوفة مثل client.chat.completions.create. تتعامل الـ SDK مع التسلسل النصي لـ JSON تلقائياً. قم بتكوين معاملات مثل temperature و top_p للتحكم في الإبداع. معرف النموذج هو دائماً uncensored. يمكنك تفعيل البث المتدفق للاستجابات أو طلب وضع JSON لاستخراج البيانات المهيكلة.

نسخfrom openai import OpenAI

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

يوضح مقتطف الرمز هذا استدعاء إكمال قياسي. يعمل مع أي عميل متوافق مع OpenAI. اضبط معامل max_tokens للتحكم في طول المخرجات. الحد الأقصى الافتراضي للمخرجات هو 2,048 رمزاً ما لم يُحدد خلاف ذلك.

استخدام SDK لـ Node.js

ثبّت حزمة Node.js من OpenAI. قم بتهيئة العميل باستخدام عنوان URL الأساسي https://api.uncensoredvideo.top/v1 ومفتاح API الخاص بك. استخدم نفس نقطة النهاية chat.completions كما في Python. تدعم حزمة Node.js أنماط async/await لدمج نظيف. يمكنك إرسال رسائل متعددة في سجل المحادثة للحفاظ على السياق. يدعم النموذج استدعاء الدوال، مما يتيح لك تعريف أدوات لاستخراج البيانات الوصفية.

نسخimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredvideo.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 دفق أحداث مرسلة من الخادم (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)

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

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

نافذة السياق هي 100,000 رمز إجمالاً. الحد الأقصى للإخراج لكل طلب هو 32,000 رمز. يمكنك إجراء 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يجب أن تكون أحجام الطلبات أقل من 8 ميجابايت. تشمل الأخطاء 401 للمفاتيح غير الصالحة و429 لحدّ المعدل. يشير 402 إلى عدم كفاية الرصيد. يُخصم رصيد مسبق الدفع فقط مقابل استخدام الرموز الفعلي. الأخطاء والرفضات مجانية. الرصيد لا ينتهي صلاحيته. لا يلزم بطاقة ائتمان للتجربة بقيمة 0.50 دولار. احصل على هذا الرصيد بنقرة واحدة في صفحة مفتاح API الخاص بك. قم بشحن الرصيد باستخدام USDT أو USDC.