أسعار Luma API: وثائق Ray 3.2 API وتكلفة كل مقطع

يكلّف مقطع واحد مدته 5 ثوانٍ بدقة 720p من Ray 3.2 مبلغ $0.30 عبر Luma API. ورفع المقطع نفسه إلى 1080p يرفع السعر إلى $1.20. وإذا أضفت HDR وتصدير EXR بدقة 1080p، فإن لقطة واحدة مدتها خمس ثوانٍ تكلّف $3.60. وتأتي هذه الأرقام مباشرة من صفحة الأسعار الرسمية لشركة Luma، وهي تحدد ما إذا كان مشروع من 200 مقطع سيكلّف ثمن غداء أم ثمن حاسوب محمول. يشرح هذا المقال كل أسعار Ray 3.2، ويمرّ على وثائق API ليتمكن من إرسال أول طلب، ويحدد تركيبات المعاملات التي ترفضها API، ويوضح كيف تبقي الفاتورة صغيرة. وإذا كنت تفضّل تجاوز الشيفرة تمامًا، ففيه أيضًا قسم عن تشغيل Ray 3.2 على PicassoIA من المتصفح.

💡 تذكر Luma أن أسعار الفيديو عرضة للتغيير قبل الإتاحة العامة. أعد التحقق من صفحة الأسعار على docs.agents.lumalabs.ai قبل أن تثبّت الميزانية.

نظرة سريعة على أسعار Ray 3.2 عبر API

تحتسب Luma سعر Ray 3.2 حسب مدة المقطع وجودة الإخراج، لا حسب عدد التوكنات. يقع كل توليد في كتلة ثابتة مدتها 5 ثوانٍ أو 10 ثوانٍ، ويرتفع السعر مع الدقة ونطاق الألوان الديناميكي. تشترك تحويلات النص إلى فيديو والصورة إلى فيديو في جدول أسعار واحد، لذا فإن مقطعًا مُحرَّكًا من صورة فوتوغرافية يكلّف المبلغ نفسه الذي يكلّفه مقطع مكتوب من أمر نصي.

أسعار نطاق الألوان الديناميكي القياسي

نطاق الألوان الديناميكي القياسي (SDR) هو الإخراج الافتراضي، وهو السعر الذي تدفعه معظم المشاريع.

يستحق الانتقال من 720p إلى 1080p نظرة ثانية. يحتوي الإطار بدقة 1080p على 2.25 ضعف عدد بكسلات الإطار بدقة 720p، لكن السعر يرتفع 4 أضعاف. ما لم تكن الوجهة تعرض فعلًا دقة 1080p، فإن الفئة الأرخص هي الخيار الافتراضي الأذكى.

أسعار تصدير HDR وEXR

يقتصر HDR على مقاطع مدتها 5 ثوانٍ بدقة 720p أو 1080p. أما تصدير EXR، وهو ملف الألوان الخام المخصص للتدريج اللوني الاحترافي، فيُضاف فوق HDR.

يضاعف HDR سعر SDR، ويرفعه EXR إلى ثلاثة أضعاف. إذا كان المقطع متجهًا إلى Instagram أو صفحة هبوط، فلن يُظهر أي شيء في سلسلة العرض ذلك النطاق الإضافي، لذا تخطَّ HDR وEXR وادفع ثلث المبلغ.

أسعار إعادة التأطير والتمديد

لعمليتين أخريين أسعار خاصة بهما، وكلتاهما لنطاق الألوان الديناميكي القياسي فقط.

• إعادة التأطير (تغيير نسبة العرض إلى الارتفاع لفيديو موجود) تُحتسب لكل ثانية: 0.03 دولار بدقة 360p، و0.06 دولار بدقة 540p، و0.12 دولار بدقة 720p، و0.36 دولار بدقة 1080p.
• التمديد من إطار مرجعي واحد يُحتسب ككتلة واحدة مدتها 5 ثوانٍ: 0.15 دولار بدقة 540p، و0.30 دولار بدقة 720p، و1.20 دولار بدقة 1080p.
• تحرير الفيديو له أسعار منفصلة لـ SDR وHDR وHDR + EXR مع فئتي 5 ثوانٍ و10 ثوانٍ، وكلها بأسعار أساسية أعلى من التوليد العادي. اطّلع على أرقام التحرير الدقيقة في صفحة الأسعار.

هناك رقم يستحق التذكر. إعادة تأطير مقطع مدته 5 ثوانٍ بدقة 720p تكلّف 5 × 0.12 = 0.60 دولار. أما توليد مقطع جديد بنسبة 9:16 من البداية فيكلّف 0.30 دولار. إذا كنت تحتاج إلى النسخة العمودية فقط لا إلى اللقطة الأصلية بالضبط، فولّدها بالنسبة الصحيحة من البداية.

ما الذي يكلّفه المقطع الواحد فعلًا

تكلفة الثانية الواحدة حسب الفئة

يؤدي تقسيم سعر كل كتلة على مدتها إلى رقم أسهل في المقارنة مع أدوات الفيديو الأخرى.

تكلّف دقيقة واحدة من اللقطات النهائية المبنية من اثني عشر مقطعًا مدة كل منها 5 ثوانٍ 3.60 دولارات بدقة 720p، و14.40 دولارًا بدقة 1080p. وهذا يفترض أنك تحتفظ بكل لقطة، وهو أمر لا يفعله أحد.

مقطعان مدة كل منهما 5 ثوانٍ أفضل من مقطع واحد مدته 10 ثوانٍ

يكلّف المقطع مدته 10 ثوانٍ بدقة 720p مبلغ 0.90 دولار. أما مقطعان مدة كل منهما 5 ثوانٍ فيكلّفان 0.60 دولار. وهذا يجعل الكتلة الأطول أغلى بنسبة 50% لكل ثانية، ويتكرر النمط نفسه عند كل دقة. عند 1080p تكون الفجوة 3.60 دولارات مقابل 2.40 دولار.

يأتي خيار 10 ثوانٍ أيضًا مع قيود. ترفض API الجمع بين 10 ثوانٍ مع HDR أو إطار البداية أو إطار النهاية أو التكرار. لذلك يكون المسار الأرخص في كثير من الأحيان الأكثر مرونة أيضًا. ولّد المقطع الأول، والتقط إطاره الأخير، ومرّر تلك الصورة بوصفها إطار البداية للمقطع الثاني حتى تستمر الحركة دون قفزة مرئية.

أمثلة على الميزانية

الآن أضف الجزء الذي تنساه معظم الميزانيات. إذا احتفظت بلقطة واحدة من كل ثلاث، فاضرب في ثلاثة. تتحول القناة الأسبوعية التي تحتفظ بعدد 100 مقطع إلى 300 توليد، أي 90 دولارًا بدلًا من 30 دولارًا.

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

جولة في وثائق Ray 3.2 API

تنشر Luma نموذج Ray 3.2 عبر وثائق Agents API الخاصة بها. ثلاثة أمور تهم قبل أول استدعاء: عنوان URL الأساسي، وترويسة المصادقة، وشكل الطلب.

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

عنوان URL الأساسي هو https://agents.lumalabs.ai/v1. تستخدم المصادقة رمز حامل (bearer token) في ترويسة Authorization. احفظ الرمز في متغير بيئة ولا تُدرجه أبدًا في مستودع. توجد حزم SDK رسمية لكل من Python وTypeScript (وكلاهما يحمل الاسم luma-agents) وحزمة Go (luma-agents-go)، إضافة إلى أداة سطر أوامر.

طلب التوليد

كل شيء يبدأ من POST /v1/generations. ثلاثة حقول مطلوبة:

• model: ويُضبط على "ray-3.2"
• type: ويُضبط على "video"
• prompt: من 1 إلى 6,000 حرف تصف الشخص والحركة وحركة الكاميرا والإضاءة والإيقاع

تضبط الحقول الاختيارية الإخراج. يقبل aspect_ratio القيم 9:16 أو 3:4 أو 1:1 أو 4:3 أو 16:9 أو 21:9. يقبل كائن video القيمة resolution (360p أو 540p أو 720p افتراضيًا، أو 1080p)، وduration ("5s" افتراضيًا، أو "10s")، إضافة إلى قيمتين منطقيتين hdr وloop.

curl https://agents.lumalabs.ai/v1/generations \
  -H "Authorization: Bearer $LUMA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ray-3.2",
    "type": "video",
    "prompt": "Slow dolly shot through a misty greenhouse at sunrise",
    "aspect_ratio": "16:9",
    "video": { "resolution": "720p", "duration": "5s" }
  }'

نسخ الأمر النصي

يُحتسب هذا الطلب بسعر 0.30 دولار: دقة 720p، و5 ثوانٍ، ونطاق ألوان ديناميكي قياسي.

الاستعلام عن حالة المهمة

يعيد الإرسال الناجح رمز HTTP 201 مع الحالة queued. استعلم عن GET /v1/generations/{id} حتى تصل المهمة إلى حالة نهائية، إما النجاح أو failed. عند النجاح يتضمن الإخراج عنوان URL موقّعًا مسبقًا لملف MP4. وروابط التوقيع المسبق مؤقتة بطبيعتها، لذا انسخ الملف إلى مساحة تخزينك الخاصة فورًا.

توقّع نحو 80 إلى 200 ثانية لكل مقطع. استغرقت أمثلة التشغيل على صفحة Ray 3.2 في PicassoIA ما بين 79 و204 ثوانٍ، لذا يكفي الاستعلام كل 5 إلى 10 ثوانٍ.

قواعد المعاملات التي تُسبّب الأخطاء

يُهدر الطلب المرفوض رحلة ذهاب وإياب، وتُهدر القاعدة المفهومة خطأً فترة ما بعد الظهر. تحدد وثائق Luma الخيارات التي لا يمكن الجمع بينها.

تعارضات HDR والتكرار و10 ثوانٍ

تحقق من هذه القواعد في شيفرتك الخاصة قبل استدعاء API. فالدالة الصغيرة التي تتحقق من التركيبة تستغرق عشر دقائق لكتابتها، وتزيل فئة كاملة من المهام الفاشلة.

حدود المعدل وأخطاء 429

ينطبق حدّان مستقلان على POST /v1/generations:

1. الطلبات في الدقيقة (RPM): أقصى عدد من الطلبات في نافذة منزلقة مدتها 60 ثانية.
2. المهام المتزامنة: أقصى عدد من عمليات التوليد النشطة في أي لحظة.

لا تنشر Luma أرقامًا دقيقة. تعتمد حدودك على خطتك وتظهر في لوحة تحكم منصة Luma. يعيد كلا الحدّين HTTP 429، ويميّز نص الاستجابة بينهما.

اضبط semaphore داخل العامل لديك وفق حد التزامن الموضح في لوحة التحكم، واحترم Retry-After بدلًا من إعادة المحاولة وفق مؤقت ثابت. وزّع الدفعة الكبيرة على مدار الدقيقة بدلًا من إرسال كل الطلبات دفعة واحدة، وعندها لن تكون نافذة RPM مشكلة.

طرق لإبقاء الفاتورة منخفضة

ابدأ بمسودة 360p أولًا

تكلّف فئة المسودة 360p مبلغ 0.06 دولار، أي خُمس سعر مقطع 720p وعشرين جزءًا من سعر مقطع 1080p. اختبر كل أمر نصي هناك، ثم رقِّ الفائزين فقط.

خذ 25 لقطة تحتاجها بدقة 1080p. توليد 25 لقطة مباشرة بدقة 1080p يكلّف 30.00 دولارًا. أما توليد 20 مسودة (1.20 دولار) ورفع 5 فائزين إلى 1080p (6.00 دولارات) فيكلّف 7.20 دولارات، أي توفير بنسبة 76%.

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

💡 ضع حدًا صارمًا لإعادة المحاولة في العامل لديك: ثلاث محاولات، ثم توقّف وسجّل الأمر النصي. الحلقة التي تعيد الإرسال عند كل فشل تحوّل خطأ بقيمة 0.30 دولار إلى فاتورة حقيقية.

طابِق الدقة مع الوجهة

اضبط aspect_ratio وقت التوليد بدلًا من إعادة التأطير لاحقًا، واستخدم علامة loop للمقاطع الخلفية بدلًا من تركيب حلقة تكرار يدويًا.

Ray 3.2 دون كتابة شيفرة

تناسب API المنتجات أو مسارات العمل المجدولة. أما للمشروع لمرة واحدة فتلغي الواجهة الإلكترونية الحاجة إلى التعامل مع التوكنات، وحلقة الاستعلام الدوري، وشيفرة حدود المعدل. تستضيف PicassoIA نموذج Ray 3.2، فتختار الإعدادات من استمارة وتنزّل ملف MP4.

تملك PicassoIA أيضًا واجهة API على طراز Replicate. وهي تعرض وقت كتابة هذا المقال أربعة نماذج من PicassoIA، من بينها PicassoIA Video وSeedance 2.5 Lite. ولا يظهر Ray 3.2 في هذه القائمة، لذا يبقى في الواجهة الإلكترونية.

ما الذي تمنحك إياه PicassoIA

تنطبق قواعد التركيبات نفسها المعتمدة في Luma API. فرق واحد: استمارة PicassoIA لا تدرج مستوى المسودة بدقة 360p. تحقق من خطتك على PicassoIA لمعرفة طريقة احتساب توليدات Ray 3.2.

كيف تستخدم Ray 3.2 على PicassoIA

1. افتح صفحة نموذج Ray 3.2.
2. اكتب أمرًا نصيًا يذكر الشخص والحركة وحركة الكاميرا والإضاءة والإيقاع.
3. ابدأ بدقة 720p ومدة 5 ثوانٍ أثناء الاختبار.
4. اختر نسبة العرض إلى الارتفاع، أو ارفع صورة بداية لتحريك صورة فوتوغرافية.
5. فعّل HDR أو التكرار فقط إذا سمحت القواعد أعلاه بذلك.
6. ولّد المقطع، وراجعه، وعدّل الأمر النصي، ثم أعد التشغيل. وعندما تبدو الحركة صحيحة، أعد التوليد بدقة 1080p.

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

بدائل أرخص ومجانية

ليس Ray 3.2 الطريقة الوحيدة للحصول على حركة سينمائية، وبسعر 1.20 دولار لكل لقطة بدقة 1080p فهو ليس الأرخص دائمًا. تتعامل نماذج PicassoIA هذه مع المهام نفسها من تحويل النص إلى فيديو وتحويل الصورة إلى فيديو:

تقسيم عملي: أنشئ النموذج الأولي على نموذج مجاني، ثم أنفق نقاط Ray 3.2 على اللقطات التي تحتاج HDR أو EXR أو إطار 21:9. وتعرض PicassoIA أيضًا فئتي رفع جودة الفيديو والدقة الفائقة في صفحة جميع النماذج. ويستحق الأمر اختبار ما إذا كان مقطع Ray 3.2 بدقة 720p، بعد رفع دقته، يحقق معيار الجودة لديك قبل أن تدفع سعر 1080p الأصلي الذي يعادل أربعة أضعاف.

ولّد أول مقطع لك اليوم

تبدو الأرقام بسيطة عند وضعها جنبًا إلى جنب. تكلّف 720p مبلغ 0.30 دولار، وتكلّف 1080p مبلغ 1.20 دولار، ويضاعف HDR السعر، ويرفعه EXR إلى ثلاثة أضعاف، ومقطعان مدة كل منهما 5 ثوانٍ أفضل من مقطع واحد مدته 10 ثوانٍ. ابدأ بالمسودة عند 360p، ووَلِّد بنسبة العرض إلى الارتفاع التي تحتاجها، وضع حدًا لإعادات المحاولة.

افتح Ray 3.2 على PicassoIA، ونفّذ أمرًا نصيًا واحدًا بدقة 720p، ثم مرّر الأمر النصي نفسه إلى Ray Flash 2 720p وSeedance 2.5 Lite. ستخبرك ثلاثة مقاطع متجاورة بأكثر مما تخبرك به أي بطاقة أسعار عن العلاقة بين السعر والجودة. أنشئ مقاطعك الخاصة الآن على picassoia.com.