- NSFW Video API
- البدء السريع: دمج النصوص غير الخاضعة للرقابة في سير عمل الفيديو الخاص بك
البدء السريع: دمج النصوص غير الخاضعة للرقابة في سير عمل الفيديو الخاص بك
دمج API النص غير الخاضع للرقابة في خط أنابيب الفيديو NSFW الخاص بك باستخدام دليل البدء السريع هذا. ستتعلم المصادقة، وتوليد النصوص، والبث المتدفق للاستجابات باستخدام عملاء متوافقين مع OpenAI.
عنوان URL الأساسي والمصادقة
يتم استضافة API الخاص بنا على https://api.nsfwvideo.top/v1. للمصادقة، تحتاج إلى مفتاح API من لوحة حسابك. يمكنك التسجيل عبر Google أو البريد الإلكتروني للحصول على مفتاحك على الفور. مرر هذا المفتاح في رأس Authorization كرمز Bearer. هذا الإعداد يعمل مع أي SDK متوافق مع OpenAI عن طريق تكوين عنوان URL الأساسي ومفتاح API. تأكد من أن عميلك يرسل الطلبات إلى نقطة النهاية الخاصة بنا للوصول إلى النموذج غير الخاضع للرقابة.
توليد نصوص الفيديو
أرسل طلب POST إلى /v1/chat/completions مع معرف النموذج uncensored. هذا النموذج مضبوط للإجابة دون رفض المحتوى للاستخدام البالغ القانوني، مما يجعله مثاليًا لنصوص الفيديو NSFW. يمكنك طلب وصف مشاهد مفصل أو حوار. يعيد API النص الذي يمكنك تغذيته مباشرة في خط أنابيب توليد الفيديو الخاص بك للحصول على إخراج متسق.
curl https://api.nsfwvideo.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."}]
}'
هندسة الموجّه مع وضع JSON
للبيانات المنظمة، استخدم المعامل response_format مضبوطًا على {"type": "json_object"}. هذا يضمن أن يعيد النموذج JSON صالح، وهو أمر أساسي لتحليل البيانات الوصفية أو الموجّهات المنظمة في سير عمل الأتمتة الخاص بك. يمكنك تعريف مخطط في موجّه النظام الخاص بك لفرض مفاتيح محددة مثل scene_description أو camera_angles. هذا يقلل من عبء المعالجة اللاحقة ويحافظ على نظافة خط الأنابيب الخاص بك.
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwvideo.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)
الاستجابات المتدفقة
فعّل البث المتدفق عن طريق تعيين stream إلى true. تُرجع واجهة برمجة التطبيقات كتلًا عبر أحداث Server-Sent (SSE). يتيح لك ذلك عرض التقدم أو معالجة الرموز في الوقت الفعلي. تحتوي كل كتلة على نص جزئي، وتشمل الكتلة الأخيرة إحصائيات استخدام الرموز. البث المتدفق فعال للنصوص الطويلة، مما يتيح لتطبيقك التفاعل مع المحتوى أثناء إنشائه دون انتظار الاستجابة الكاملة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwvideo.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);
التعامل مع نوافذ السياق
نافذة السياق هي 100,000 رمز، تغطي كلًا من الموجّه والإكمال. الحد الأقصى للإخراج لكل طلب هو 32,000 رمز، أو 2,048 إذا لم يتم تعيين max_tokens. خطط لطول الإدخال الخاص بك وفقًا لذلك لتجنب التقطيع. للمحادثات الطويلة، أدر السجل عن طريق تقصير الرسائل الأقدم. هذا يضمن أن يكون لدى النموذج مساحة كافية للسياق ذي الصلة، والحفاظ على الاتساق في توليد نصوص الفيديو الخاصة بك.
حدّ المعدل والرموز
أنت محدود بـ 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. الأخطاء مثل 401 (مفتاح غير صالح) أو 402 (لا رصيد) لا تستهلك رصيدك المسبق الدفع. حدّ المعدل (429) أيضًا لا يستهلك الرصيد، مما يتيح لك إعادة المحاولة دون عقوبة. يتم تحميل الرصيد فقط مقابل استخدام الرموز الناجح، مما يضمن التحكم في التكلفة لخطوط الأنابيب عالية الحجم.
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)مواصفات API
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| معرّف النموذج | uncensored |
| المصادقة | Authorization: Bearer YOUR_KEY |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.nsfwvideo.top/v1 |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| وضع JSON | response_format: {"type": "json_object"} |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| مكافأة | +5% من $50، +10% من $100 |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
ماذا يحدث إذا نفد الرصيد؟
يبقى مفتاح API الخاص بك نشطًا، لكن الطلبات ستعيد خطأ 402 يشير إلى عدم كفاية الأموال. يمكنك شحن الرصيد عبر العملات المشفرة في أي وقت لاستئناف الاستخدام. الأخطاء والرفض مجانيان، لذا لن يتم تحميلك مقابل المحاولات الفاشلة.
هل يدعم API استدعاء الدوال؟
نعم، يدعم API استدعاء الدوال عبر المعاملات <code>tools</code> و <code>tool_choice</code>. يمكنك تعريف دوال مخصصة في طلبك لجعل النموذج يعيد بيانات منظمة. هذا مفيد للدمج مع أجزاء أخرى من سير عمل إنتاج الفيديو الخاص بك.
هل هناك طبقة مجانية؟
لا، لا توجد طبقة مجانية. ومع ذلك، يحصل كل حساب جديد على رصيد تجريجي بقيمة $0.50 صالح لمدة 7 أيام. يمكنك شحن الرصيد بالعملات المشفرة بدءًا من $10. الرصيد لا ينتهي أبدًا ويمكن استخدامه لأي نوع من الطلبات.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.