كيفية استخدام LTX-2 API؟

تمكن واجهة برمجة تطبيقات LTX-2 المطورين من إنشاء محتوى فيديو جذاب باستخدام الذكاء الاصطناعي. تتيح هذه الخدمة، المقدمة من Lightricks، للمستخدمين تحويل الأوصاف النصية أو الصور الثابتة إلى مقاطع فيديو متزامنة مع الصوت. يقوم المهندسون بدمجها في التطبيقات لمهام تتراوح من إنشاء المحتوى إلى النماذج الأولية للمؤثرات البصرية. علاوة على ذلك، تدعم واجهة برمجة التطبيقات نماذج متنوعة محسّنة للسرعة أو الجودة، مما يتيح التخصيص بناءً على احتياجات المشروع.

💡

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

زر

لذلك، فكر في تنزيل Apidog مجانًا لتعزيز تفاعلك مع واجهة برمجة تطبيقات LTX-2 والتركيز بشكل أكبر على الابتكار بدلاً من الإعداد.

ما هي واجهة برمجة تطبيقات LTX-2؟

يستخدم المطورون واجهة برمجة تطبيقات LTX-2 لإنشاء مقاطع الفيديو برمجيًا. تستفيد هذه الخدمة القائمة على RESTful من نماذج الذكاء الاصطناعي المتقدمة لإنتاج مخرجات سينمائية من مدخلات بسيطة. على وجه التحديد، توفر ثلاث قدرات أساسية: توليد الفيديو من النص، تحويل الصورة إلى فيديو، ووظيفة إعادة اللقطة لتحرير مقاطع الفيديو.

تعتمد واجهة برمجة التطبيقات على نموذج LTX-2، وهو أساس قائم على محول الانتشار (DiT) ينشئ صوتًا وفيديو متزامنين في تمريرة واحدة. يقدم المستخدمون المطالبات، ويقوم النظام بإنشاء مقاطع فيديو تصل مدتها إلى 20 ثانية، اعتمادًا على النموذج والتكوين المحددين. بالإضافة إلى ذلك، يدعم دقة عالية مثل 4K ومعدلات إطارات تصل إلى 50 إطارًا في الثانية، مما يجعله مناسبًا للتطبيقات الاحترافية.

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

مقارنة بالبدائل مفتوحة المصدر، تجرد واجهة برمجة تطبيقات LTX-2 المستضافة متطلبات الأجهزة. يتجنب المطورون إدارة وحدات معالجة الرسومات أو تثبيت أطر عمل مثل ComfyUI، ويركزون بدلاً من ذلك على التكامل. ومع ذلك، بالنسبة لأولئك الذين يفضلون التنفيذ المحلي، توفر Lightricks نموذج LTX-2 مفتوح المصدر على GitHub، ولكن هذا الدليل يركز على واجهة برمجة التطبيقات لتحقيق الكفاءة المستندة إلى السحابة.

البدء باستخدام واجهة برمجة تطبيقات LTX-2

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

يعمل هذا المفتاح كرمز الوصول الخاص بك. قم بتخزينه بأمان، حيث يقوم بمصادقة جميع الطلبات. على سبيل المثال، ضعه في متغيرات البيئة لتجنب الترميز الثابت في النصوص البرمجية. في Bash، قم بتنفيذ export LTXV_API_KEY="your_key_here". يسترجعه مطورو Python باستخدام import os; api_key = os.environ.get("LTXV_API_KEY"). يصل إليه مستخدمو Node.js عبر process.env.LTXV_API_KEY.

بعد تأمين المفتاح، اختبر الاتصال بطلب بسيط. استخدم أدوات مثل curl أو Apidog للتحقق من الإعداد. تؤكد هذه الخطوة حالة حسابك وتعرفك على تنسيق استجابة واجهة برمجة التطبيقات. إذا نشأت مشكلات، تحقق من الأخطاء الشائعة مثل المفاتيح غير الصالحة، والتي تعيد حالة 401.

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

كيفية مصادقة الطلبات في واجهة برمجة تطبيقات LTX-2؟

تحمي المصادقة الوصول إلى واجهة برمجة التطبيقات. قم بتضمين المفتاح في رأس المصادقة لكل طلب باستخدام تنسيق Bearer. على وجه التحديد، قم بتعيين Authorization: Bearer YOUR_API_KEY.

على سبيل المثال، يبدو أمر curl كالتالي:

curl -X POST https://api.ltx.video/v1/text-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A serene mountain landscape at dawn", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}'

تستخدم تطبيقات Python مكتبة requests:

import requests
import os

api_key = os.environ.get("LTXV_API_KEY")
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
payload = {
    "prompt": "A serene mountain landscape at dawn",
    "model": "ltx-2-pro",
    "duration": 8,
    "resolution": "1920x1080"
}
response = requests.post("https://api.ltx.video/v1/text-to-video", headers=headers, json=payload)
if response.status_code == 200:
    with open("video.mp4", "wb") as f:
        f.write(response.content)

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

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

فهم النماذج المدعومة في واجهة برمجة تطبيقات LTX-2

توفر واجهة برمجة تطبيقات LTX-2 نموذجين أساسيين: ltx-2-fast و ltx-2-pro. كل منهما مُحسّن لأولويات مختلفة.

يعطي نموذج ltx-2-fast الأولوية للكفاءة. يدعم دقة تصل إلى 3840x2160، ومعدل إطارات (FPS) يبلغ 25 أو 50، ومدد تتراوح من 6 إلى 20 ثانية في بعض التكوينات. على سبيل المثال، عند دقة 1920x1080 و 25 إطارًا في الثانية، يتعامل مع ما يصل إلى 20 ثانية. يناسب هذا النموذج النماذج الأولية السريعة حيث تكون السرعة أهم من الإتقان.

على النقيض من ذلك، يركز نموذج ltx-2-pro على الجودة. يحدد المدد بـ 6 أو 8 أو 10 ثوانٍ ولكنه يقدم تفاصيل وتماسكًا فائقين. كما يدعم دقة تصل إلى 3840x2160 ومعدل إطارات (FPS) يبلغ 25 أو 50. يختاره المطورون للمخرجات النهائية التي تتطلب صقلًا.

ارجع إلى مصفوفة دعم النموذج هذه للحصول على تركيبات دقيقة:

النموذج	الدقة	الإطارات في الثانية	المدة (بالثواني)
ltx-2-fast	1920x1080	25	6, 8, 10, 12, 14, 16, 18, 20
	1920x1080	50	6, 8, 10
	2560x1440	25, 50	6, 8, 10
	3840x2160	25, 50	6, 8, 10
ltx-2-pro	1920x1080	25, 50	6, 8, 10
	2560x1440	25, 50	6, 8, 10
	3840x2160	25, 50	6, 8, 10

اختر النماذج بناءً على المتطلبات. على سبيل المثال، استخدم ltx-2-fast أثناء تكرارات التطوير، ثم انتقل إلى ltx-2-pro للإنتاج. لاحظ أن الدقة العالية والمدد الأطول تستهلك المزيد من الأرصدة.

إتقان نقطة نهاية تحويل النص إلى فيديو في واجهة برمجة تطبيقات LTX-2

يستدعي المطورون نقطة نهاية تحويل النص إلى فيديو لإنشاء مقاطع فيديو من الأوصاف. عنوان URL هو https://api.ltx.video/v1/text-to-video، باستخدام طريقة POST.

المعلمات المطلوبة تشمل:

prompt: سلسلة نصية، بحد أقصى 5000 حرف، تصف المشهد.
model: تعداد، إما "ltx-2-fast" أو "ltx-2-pro".
duration: عدد صحيح، بالثواني، حسب قيود النموذج.
resolution: سلسلة نصية، مثل "1920x1080".

المعلمات الاختيارية تعزز التحكم:

fps: عدد صحيح، القيمة الافتراضية 25.
camera_motion: تعداد لتأثيرات مثل التحريك أو التكبير (القيم المحددة غير مفصلة هنا، ارجع إلى التوثيق).
generate_audio: قيمة منطقية، القيمة الافتراضية true للصوت المتزامن.

يتوقع الطلب محتوى JSON. الاستجابات الناجحة تعيد ملف MP4 في الجسم، مع Content-Type: video/mp4.

على سبيل المثال، قم بإنشاء فيديو مدته 8 ثوانٍ:

curl -X POST https://api.ltx.video/v1/text-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A majestic eagle soaring through clouds at sunset", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}' \
-o video.mp4

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

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

استكشاف نقطة نهاية تحويل الصورة إلى فيديو في واجهة برمجة تطبيقات LTX-2

تقوم نقطة نهاية تحويل الصورة إلى فيديو بتحريك الصور الثابتة. تستخدم طريقة POST للوصول إلى https://api.ltx.video/v1/image-to-video.

تعكس المعلمات الرئيسية تحويل النص إلى فيديو ولكن تضيف image_uri: سلسلة نصية، وهي عنوان URL للصورة المدخلة (HTTPS، حتى 32 ميجابايت، بتنسيقات مثل JPG).

مثال على طلب:

curl -X POST https://api.ltx.video/v1/image-to-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_uri": "https://example.com/sunset.jpg", "prompt": "Clouds drifting across the sky as the sun sets slowly", "model": "ltx-2-pro", "duration": 8, "resolution": "1920x1080"}' \
-o video.mp4

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

تتطابق القيود مع النماذج: تحقق من المدة والدقة. إذا فشل جلب الصورة، توقع أخطاء 400.

استخدام ميزة إعادة اللقطة في واجهة برمجة تطبيقات LTX-2

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

على الرغم من أن مواصفات نقطة النهاية التفصيلية تتطور، فمن المرجح أنها تستخدم POST إلى مسار مثل /v1/retake. تشمل المعلمات video_uri للملف الأصلي، و start_time و end_time بالثواني، و prompt للتغييرات.

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

راقب التحديثات في التوثيق للحصول على المعلمات الكاملة. حاليًا، تعيد كتابة اللحظات بكفاءة مع الحفاظ على التزامن.

معالجة الأخطاء في واجهة برمجة تطبيقات LTX-2

توحد واجهة برمجة التطبيقات استجابات الأخطاء:

{
  "type": "error",
  "error": {
    "type": "error_type",
    "message": "Description"
  }
}

الأكواد الشائعة:

400: طلب غير صالح، على سبيل المثال، مطالبة مفقودة.
401: مشكلة مصادقة.
402: أرصدة غير كافية.
413: حمولة كبيرة جدًا.
422: محتوى تم تصفيته.
429: تجاوز حد المعدل أو التزامن.
500: خطأ في الخادم.
503: غير متاح.

تعامل بلطف: أعد المحاولة عند 429 باستخدام رأس Retry-After. تحقق من الأرصدة لـ 402. سجل الرسائل لتصحيح الأخطاء.

أفضل الممارسات: تحقق من المدخلات من جانب العميل، طبق التراجع الأسي لإعادة المحاولات.

إدارة حدود المعدل في واجهة برمجة تطبيقات LTX-2

تمنع حدود المعدل إساءة الاستخدام. وهي تشمل التزامن (الطلبات المتزامنة) والمعدل (الطلبات لكل فترة زمنية)، وتختلف حسب الخطة.

يتسبب التجاوز في إرجاع 429 مع رأس Retry-After. أنواع الأخطاء: rate_limit_error أو concurrency_limit_error.

راقب عبر الرؤوس. قم بالتحسين عن طريق التجميع حيثما أمكن، واستخدام دقة أقل للاختبارات، وترقية الخطط.

اتصل بالدعم لزيادة الحدود.

أفضل الممارسات لدمج واجهة برمجة تطبيقات LTX-2

نفذ معالجة أخطاء وتسجيلًا قويين. استخدم المعالجة غير المتزامنة إذا كنت تقوم بالتوسع.

قم بتأمين المفاتيح باستخدام الخزائن. اختبر المطالبات على نطاق واسع.

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

ادمجه مع سير العمل: أنشئ صورًا مصغرة من الصور، ثم مقاطع فيديو كاملة.

استخدام Apidog مع واجهة برمجة تطبيقات LTX-2

يبسط Apidog عملية الاختبار. استورد نقاط النهاية، اضبط الرؤوس، وأرسل الطلبات بصريًا.

أنشئ مجموعات لطلبات واجهة برمجة تطبيقات LTX-2. قم بتصحيح الاستجابات، بما في ذلك ملفات MP4 الثنائية.

يدعم بيئات المفاتيح، مما يسهل التبديل.

قم بتنزيل Apidog مجانًا لتعزيز الإنتاجية.

أمثلة متقدمة باستخدام واجهة برمجة تطبيقات LTX-2

في Python، قم بإنشاء غلاف:

import requests
import os

class LTX2API:
    def __init__(self):
        self.api_key = os.environ.get("LTXV_API_KEY")
        self.base_url = "https://api.ltx.video/v1"

    def generate_text_to_video(self, prompt, model="ltx-2-pro", duration=8, resolution="1920x1080"):
        headers = {"Authorization": f"Bearer {self.api_key}", "Content-Type": "application/json"}
        payload = {"prompt": prompt, "model": model, "duration": duration, "resolution": resolution}
        response = requests.post(f"{self.base_url}/text-to-video", headers=headers, json=payload)
        if response.status_code == 200:
            return response.content
        else:
            raise Exception(response.json()["error"]["message"])

# Usage
api = LTX2API()
video_data = api.generate_text_to_video("A futuristic cityscape at night")
with open("output.mp4", "wb") as f:
    f.write(video_data)

قم بالتوسيع لتحويل الصورة إلى فيديو. استخدمه في تطبيقات الويب عبر Flask أو Django.

الخلاصة

تُحدث واجهة برمجة تطبيقات LTX-2 تحولًا في إنشاء الفيديو. باتباع هذا الدليل، يستغل المطورون قوتها بفعالية. ابدأ بالأساسيات، وحسن المطالبات، ووسع نطاق التكاملات. تعمل أدوات مثل Apidog على تبسيط العملية، مما يضمن تطويرًا سلسًا.

زر