AR ▾

نص API من Unfiltered Video: سير عمل LLM للسيناريوهات

إذا كنت تبحث عن واجهة برمجة تطبيقات (API) للنصوص الخاصة بالفيديو غير الخاضع للرقابة، فإن التقسيم المفيد هو هذا: يقوم المُنتِج بإنشاء البكسل، وتكتب واجهة برمجة تطبيقات (API) لنموذج لغوي كبير (LLM) للنصوص كل شيء حولها، من النصوص وقوائم اللقطات إلى التسميات والأوصاف. يبني هذا الدليل الجزء النصي على نقطة نهاية متوافقة مع OpenAI.

محدّث

شريط فيلم يتحول إلى كتل نصية متدفقة في طرفية، يوضح سير عمل نص LLM للفيديو

نقاط رئيسية

  • الواجهة هي للنصوص فقط. تكتب النصوص، وقوائم اللقطات، والتسميات، والأوصاف؛ ولا تُنتج الفيديو أو الصور أو الصوت.
  • يعطيك البث المتدفق مسودة نصية أثناء كتابتها، ويعطيك وضع JSON قائمة لقطات يمكن للكود الخاص بك تحليلها.
  • تحتوي نافذة الـ 100,000 رمز على نص طويل كامل بالإضافة إلى تعليماتك في طلب واحد.
  • تتطلب عملية معالجة نص كاملة لفيديو واحد كسراً من سنت واحد بتكلفة $0.15 و $0.50 لكل مليون رمز (token).

أين يناسب النص في خط أنابيب الفيديو

لا يولد API الخاص بهذا الموقع مقاطع فيديو. هو للنص فقط: لا مخرجات صور أو صوت أو فيديو، ولا تضمينات (embeddings)، ولا ضبط دقيق (fine-tuning). هذا مهم لأن العبارة تُقرأ بطريقتين. يريد بعض الأشخاص نموذجاً يقوم بإنشاء مقاطع، وهذا يتطلب نموذج فيديو منفصلاً. آخرون لديهم بالفعل أداة إنشاء أو مكتبة أصول أو محرر، ويحتاجون إلى LLM يكتب النص المحيط دون رفض مواضيع قانونية لكنها غير مريحة: سيناريوهات الرعب، إعادة تمثيل جرائم حقيقية، كوميديا سوداء، سرد وثائقي عن الحروب، روايات ناضجة للكبار.

المجموعة الثانية هي الجمهور المستهدف لهذه المقالة. في الممارسة العملية، ينقسم العمل النصي حول الفيديو إلى أربع مهام:

  • صياغة السيناريو. حوّل مخططاً أو مجموعة من الملاحظات إلى سرد بصوت متسق.
  • قوائم اللقطات. قسّم النص إلى مشاهد مع مدة، ووصف مرئي، وخط سرد لكل منها، بتنسيق JSON يمكن لكود التحرير الخاص بك قراءته.
  • تنظيف التسميات التوضيحية والترجمات. أصلح علامات الترقيم وتسميات المتحدثين في نص طويل خام، أو اكتب نصاً على الشاشة.
  • العناوين والوصف والوسوم. مخرجات قصيرة، وكثيرة منها، وهو ما يجعل التسعير لكل رمز (token) في صالحك.

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

قم بتوصيل العميل

تتحدث نقطة النهاية بتنسيق إكمالات الدردشة الخاص بـ OpenAI، لذا يعمل أي SDK من OpenAI بعد تغيير قيمتين: عنوان URL الأساسي والمفتاح. معرف النموذج هو uncensored، والمصادقة عبارة عن رمز حامل (Bearer token) قياسي. توجد طريقتان: POST /v1/chat/completions و GET /v1/models.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

# sanity check: the model list should include "uncensored"
print([m.id for m in client.models.list().data])
MODEL = "uncensored"

إذا كنت تفضل استخدام سطر الأوامر، فإن نفس الفحص يتم بطلب واحد:

curl https://api.unfilteredvideo.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a two-line cold open for a ghost-story video."}]}'

يمكنك الحصول على مفتاح من صفحة مفتاح API. يمكن للحسابات الجديدة المطالبة بـ $0.50 من رصيد تجريبي بنقرة واحدة، صالح لمدة 7 أيام ولا يتطلب بطاقة، وهو ما يكفي لكل ما يلي.

الخطوة 1: بث مسودة السيناريو

السيناريو هو أطول مخرجات في خط الأنابيب، لذا فهو يستحق البث المتدفق. مع stream: true يرسل الخادم الرموز عبر SSE كما يتم إنتاجها، وتصل أرقام الاستخدام في نهاية البث. يمكن لأداة التحرير الخاصة بك إظهار المسودة وهي تنمو بدلاً من التجميد طوال مدة التوليد.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

outline = """Cold open: abandoned lighthouse at night.
Act 1: the keeper's logbook, last entry torn out.
Act 2: the tide table that does not match the moon.
Close: the lamp turns on by itself."""

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    temperature=0.9,
    messages=[
        {"role": "system", "content": "You write narration for short horror videos. Second person, present tense, about 90 seconds spoken."},
        {"role": "user", "content": outline},
    ],
)

script = []
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        piece = chunk.choices[0].delta.content
        script.append(piece)
        print(piece, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\n\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)

script = "".join(script)

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

الصوت هو ما يتجول عبر سلسلة من الفيديوهات. ضع قواعد القناة في رسالة النظام واجعلها ثابتة: شخصية الراوي وزمنه، طول الجملة، الكلمات التي يجب تجنبها، وكيفية إنهاء الافتتاح البارد. أضف قائمة قصيرة بالأشياء التي يجب ألا يفعلها السيناريو، مثل شرح المفاجأة مبكراً. كما أن رسالة النظام المستقرة تجعل حسابات الرموز (tokens) الخاصة بك متوقعة من فيديو لآخر، وهو ما يساعدك عند وضع الميزانية لاحقاً.

لإنتاج مسودات قابلة للتكرار أثناء ضبط الموجّه، مرر seed بقيمة ثابتة و temperature أقل. للمسودة الإبداعية الأولى، تعطي درجة حرارة حول 0.8 إلى 1.0 سرداً أكثر مرونة وحيوية، ويمكنك تخفيضها بمجرد أن تكون تقوم بالتلميع.

الخطوة 2: تحويل السيناريو إلى قائمة لقطات

كود التحرير يريد الهيكل، وليس الفقرات. يطلب وضع JSON النموذج لإرجاع كائن JSON واحد، وتفعّله بـ response_format. قل أيضاً كلمة JSON في الموجّه الخاص بك ووصف الشكل الذي تريده؛ الاثنان معاً يبقيان المخرجات على الشكل المطلوب.

import json, os
from openai import OpenAI

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

def shot_list(script_text):
    resp = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.3,
        messages=[
            {"role": "system", "content": (
                "Return JSON only: {\"shots\": [{\"n\": int, \"seconds\": number, "
                "\"visual\": string, \"narration\": string}]}. "
                "Keep each shot between 3 and 8 seconds."
            )},
            {"role": "user", "content": script_text},
        ],
    )
    data = json.loads(resp.choices[0].message.content)
    return data["shots"]

for s in shot_list(script):
    print(s["n"], s["seconds"], s["visual"][:60])

وضع JSON يجعل المخرجات السيئة نادرة، وليس مستحيلة. لف json.loads في كتلة try، وأعد المحاولة مرة واحدة بدرجة حرارة أقل، وقم بالتحقق من الحقول التي تعتمد عليها. ستؤدي قائمة اللقطات ذات قيمة seconds المفقودة إلى كسر خط زمني بشكل أكثر وضوحاً من جملة متعثرة قليلاً.

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

الخطوة 3: التسميات التوضيحية والأوصاف من نص طويل كامل

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

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.unfilteredvideo.com/v1",
});

const transcript = fs.readFileSync("interview.txt", "utf8");

const res = await client.chat.completions.create({
  model: "uncensored",
  temperature: 0.4,
  messages: [
    { role: "system", content: "You write video metadata. Reply with a title under 70 characters, a 3 sentence description, and 8 tags separated by commas." },
    { role: "user", content: transcript },
  ],
});

console.log(res.choices[0].message.content);
console.log(res.usage);

لتنظيف التسميات التوضيحية، افصل حسب الوقت بدلاً من الحجم. أرسل بضع دقائق من النص المبدئي في كل مرة مع التعليمات للحفاظ على الطوابع الزمنية دون تغيير، ثم ادمجها. إذا كنت بحاجة أيضاً إلى تسميات توضيحية على الشاشة تتناسب مع نمط المنزل، ضع قواعد النمط في رسالة النظام واجعلها متطابقة عبر المكالمات؛ هذا يجعل المخرجات متسقة ويجعل حساب الرموز (tokens) متوقعاً.

استدعاء الدوال متاح أيضاً، إذا أردت أن يستدعي النموذج دوالك الخاصة، مثل دالة lookup_asset التي تبحث في مكتبة لقطاتك عن لقطة مطابقة أثناء كتابة قائمة اللقطات. عرّف الأدوات، واقرأ tool_calls من الرد، ونفّذها، ثم أرسل النتائج كرسائل role: "tool".

حدود تُشكّل خط الأنابيب

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و 300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 متزامن و 60 في الدقيقة. حد حجم الطلب هو 8 ميجابايت، وهو أعلى بكثير من أي نص سترسله كنص. بعد تجاوز الحد، تحصل على HTTP 429 مع رمز الخطأ rate_limited (الكثير في الدقيقة) أو concurrency (الكثير في وقت واحد). في حالة الحمل الزائد المؤقت، تحصل أيضاً على 429، مع رأس Retry-After: 5.

القاعدة البسيطة: عند أي خطأ 429، انتظر قيمة الرأس إذا وجدت، وإلا فانتظر بضع ثوانٍ ثم أعد المحاولة. الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا لا تكلفك إعادة المحاولة أي شيء. تتضمن الاستجابات X-Request-Id لأسئلة الدعم، وX-Balance-USD، وهو مفيد لإظهار الرصيد المتبقي داخل أداتك الخاصة.

عند عرض العديد من الفيديوهات بالتزامن، خصّص مرحلة النص لمجموعة عمال صغيرة مستقلة تتراوح بين 4 و6، حتى لا تؤدي موجة من المسودات إلى حرمان خطوة قائمة اللقطات. تُحتسب البث المتدفق ضد حدّ الطلبات المتزامنة طوال الوقت الذي تكون فيه مفتوحة، لذا فإن المستخدم الذي يترك مسودة غير مقروءة بالكامل لا يزال يحتفظ بمكان حتى ينتهي.

تكلفة الجانب النصي لفيديو واحد

التسعير هو $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، من رصيد مسبق الدفع بدون اشتراك. إليك معالجة نص واقعية لفيديو مدته 90 ثانية، مع عرض الحساب:

الخطوةالرموز المدخلةالرموز المخرجةالتكلفة
مسودة السيناريو6001,200600 × $0.15/1M = $0.00009، زائد 1,200 × $0.50/1M = $0.0006، المجموع $0.00069
قائمة اللقطات1,500900$0.000225 + $0.00045 = $0.000675
العنوان، الوصف، الوسوم1,800300$0.00027 + $0.00015 = $0.00042

تضيف الخطوات الثلاث لتصبح $0.001785 لكل فيديو. ألف فيديو هي $1.785 من النص. حتى لو كانت الموجّهات الخاصة بك أطول ثلاث مرات من هذه، فإن الكتابة هي الجزء الرخيص من المهمة. رصيد التجربة البالغ $0.50 يغطي أكثر من 250 فيديو بأحجام هذه، لأن $0.50 مقسوماً على $0.001785 يساوي حوالي 280.

بعد التجربة، يأتي الرصيد من شحنات الرصيد بأي مبلغ صحيح من $20 إلى $500، مدفوعاً بالعملات المشفرة (USDT على TRC20 أو USDC على Base). تنطبق المكافآت على شحنات الرصيد الأكبر: +5% من $50، +10% من $100، +15% من $200. الرصيد لا ينتهي، ولا تُستخدم الموجّهات للتدريب. يصف صفحة التسعير التفاصيل، والبدء السريع يحتوي على نفس تنسيق الطلب في عدد قليل من اللغات الأخرى.

أسئلة وأجوبة

هل يمكن لـ API هذا توليد الفيديو؟

لا. هو نص فقط، بدون توليد صور أو صوت أو فيديو. استخدمه للنصوص، وقوائم اللقطات، والتسميات التوضيحية والأوصاف، وادمجه مع أداة العرض أو المحرر الذي تختاره.

هل يرفض الموضوعات المظلمة أو الناضجة؟

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

ما هو معرف النموذج وعنوان URL الأساسي الذي أستخدمه؟

استخدم معرف النموذج uncensored وعنوان URL الأساسي https://api.unfilteredvideo.com/v1 مع أي SDK متوافق مع OpenAI. المصادقة باستخدام رمز Bearer.

هل هناك خطة مجانية؟

لا توجد خطة مجانية. يمكن للمستخدمين الجدد الحصول على رصيد تجريبي لمرة واحدة بقيمة $0.50، صالح لمدة 7 أيام، بدون بطاقة؛ بعد ذلك تقوم بشحن الرصيد من $20.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.

احصل على مفتاح API