مفتاح Seedance 2.0 API مجانًا: الوصول عبر fal وأمثلة GitHub

بحثت عن Seedance 2.0 API مجانية لأنك تريد تشغيل نموذج الفيديو من ByteDance داخل برنامجك الخاص، دون فاتورة تفاجئك في نهاية الشهر. هدف معقول. الجواب الصريح يأتي في شقين. تستضيف fal نقطة نهاية جاهزة لنموذج Seedance 2.0، لكنها استخدام مدفوع يُحتسب حسب الاستهلاك. أما المسارات المجانية فتوجد في مكان آخر. فيما يلي ستجد نقطة نهاية fal الدقيقة، وكل معامل تقبله، واستدعاءات Python وJavaScript تعمل، وقائمة تحقق لتقييم أمثلة GitHub، ومسارًا مجانيًا على PicassoIA يمكنك استخدامه اليوم.

💡 الخلاصة السريعة: تمنحك fal أنظف تجربة للمطورين مع Seedance 2.0، ويمنحك PicassoIA أرخص مكان لتجربته. ابحث عن أمر نصي يعمل على PicassoIA، ثم أنفق على fal فقط عندما تحتاج إلى حجم كبير عبر البرمجة.

هل توجد واجهة Seedance 2.0 API مجانية حقًا؟

الجواب المختصر: ليس على fal، وفقًا لصفحة الأسعار العامة. ينتج Seedance 2.0 مقاطع فيديو بصوت مدمج، وتحتسب واجهات API الأسعار عن كل ثانية مولّدة لأن كل مقطع يستهلك وقت معالجة حقيقيًا على GPU. أي مضيف يقدم وصولًا مجانيًا غير محدود سيفلس خلال أسبوع.

ما الذي تفرضه fal فعليًا؟

تتيح fal النموذج عبر نقطة النهاية bytedance/seedance-2.0/text-to-video. تسرد صفحة أسعارها الاستخدام المدفوع للنماذج، ولم تُظهر، عند فحصي لها، أي أرصدة مجانية. تضع المقارنات الخارجية السعر قرب 0.24 دولار لكل ثانية للمستوى الأساسي و0.30 دولار لكل ثانية للمستوى عالي الجودة. تعامل مع هذه الأرقام كما نُقلت عن مصادرها، وتحقق منها في صفحة النموذج قبل أن تضع ميزانية.

إليك ما تعنيه هذه الأسعار المنقولة لكل مقطع:

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

كيف تكشف العروض المجانية المزيفة

نتائج البحث حول هذا الموضوع مليئة بصفحات تعد بـ"بيانات اعتماد مجانية غير محدودة". كن متشككًا. تتكرر ثلاثة أنماط بوضوح:

• رموز مشتركة منشورة في مستودعات عامة. تُلغى خلال ساعات، واستخدام أحدها قد ينتهك شروط المضيف.
• أغلفة "مجانية" تعيد بيع نماذج أرخص تحت اسم Seedance. المخرجات لا تشبه الأصل بأي شكل.
• قمع تسجيل يطلب بيانات الدفع قبل أن يعرض أي سعر.

إذا لم يكن الرمز مرتبطًا بحسابك، فهو ليس لك لتستخدمه.

الوصول إلى fal في عشر دقائق

تحتاج إلى ثلاثة أشياء: حساب، ورمز، ومكتبة عميل. لا شيء غير ذلك.

إنشاء الحساب والرمز

سجّل على fal.ai، وافتح لوحة التحكم، وأنشئ رمز API. انسخه مرة واحدة واحفظه في مدير كلمات المرور. ثم اضبطه كمتغير بيئة حتى لا يحتفظ أي برنامج به كنص صريح:

export FAL_KEY="paste-your-token-here"
pip install fal-client

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

تقرأ مكتبة Python للعميل FAL_KEY تلقائيًا. لا تُدرج القيمة أبدًا في Git، ولا تضعها في شيفرة المتصفح.

أول استدعاء لك بلغة Python

يستخدم الطلب أدناه أسماء المعاملات التي تنشرها نقطة النهاية. subscribe يرسل المهمة، وينتظر في الطابور، ويعيد النتيجة:

import fal_client
import requests

def on_update(update):
    print(update)

result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "A potter shapes wet clay on a wheel, warm window light, slow push-in, soft sounds of wet clay",
        "resolution": "720p",
        "duration": "5",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
    with_logs=True,
    on_queue_update=on_update,
)

video_url = result["video"]["url"]
with open("clip.mp4", "wb") as f:
    f.write(requests.get(video_url, timeout=120).content)
print("Seed:", result["seed"])

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

الاستجابة كائن JSON يحتوي على كائن ملف video (url، content_type، file_name، file_size) وseed الذي أنتجه. سجّل البذرة بجانب الأمر النصي حتى تتمكن من تتبع أي تشغيل أنتج أي ملف. حقل duration من نوع تعداد، لذا انسخ الصيغة الدقيقة الموضحة في المخطط في صفحة النموذج.

نسخة JavaScript

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("bytedance/seedance-2.0/text-to-video", {
  input: {
    prompt: "A potter shapes wet clay on a wheel, warm window light, slow push-in",
    resolution: "720p",
    aspect_ratio: "16:9",
  },
  logs: true,
});

console.log(result.data.video.url);

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

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

التعامل مع الأخطاء وانتهاء المهلة

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

أمثلة GitHub تستحق النسخ

ابحث في GitHub عن Seedance 2.0 وستجد عشرات المستودعات: نصوص سريعة، وعروض Next.js، ومُصيّرات دفعات، وعقد ComfyUI. الجودة تتفاوت كثيرًا. لن أسمّي مستودعات بعينها، لأنها تتغير أسبوعيًا، لكن يمكنك تقييم أي منها في دقيقتين.

ما الذي يُظهره المستودع الجيد

• معرّف نقطة النهاية الدقيق، مطابقًا لصفحة النموذج حرفًا بحرف.
• رموز تُقرأ من متغيرات البيئة، مع ملف .env.example وبلا قيم حقيقية.
• معالجة الطابور: الإرسال، ثم الاستعلام أو استخدام webhook، ثم الجلب. الاستدعاءات المتزامنة مقبولة للاختبارات، لكن مهام الدفعات تحتاج إلى الطابور.
• معالجة الأخطاء للمهام الفاشلة ولانتهاء المهلة، مع إعادة المحاولة بعد توقف.
• تاريخ حديث للالتزام الأخير. النموذج جديد، ومخططه تغيّر بسرعة.

علامات التحذير في الأمثلة البرمجية

💡 قبل تشغيل أي نص منسوخ، ابحث فيه عن http:// وrequests.post، واقرأ كل عنوان خارجي. أي عنوان ليس مضيف fal أو خادمك الخاص يستحق السؤال.

طريقة آمنة لاختبار أي مستودع

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

الإعدادات التي تغيّر النتيجة

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

المدة والدقة

المقاطع الأطول والدقات الأعلى يرفعان السعر كلاهما. اعمل المسودة على 720p ومدة 5 ثوانٍ. انتقل إلى 1080p فقط للقطة التي تنوي نشرها، واحتفظ بدقة 4k للقطات الرئيسية التي تبرر تكلفتها.

الصوت ونسبة العرض والترميز

أبقِ generate_audio مفعّلًا ما لم تنوِ تأليف الموسيقى للمقطع بنفسك، لأن الصوت المتزامن جزء كبير من جاذبية النموذج. استخدم 9:16 لمنصتي Shorts وReels، و16:9 لمنصة YouTube والإعلانات الإلكترونية على الويب. اختر H264 لأوسع دعم للتشغيل، وH265 عندما يكون حجم الملف أهم من الأجهزة القديمة.

مسارات مجانية تعمل اليوم

Seedance على PicassoIA

يشغّل PicassoIA عائلة Seedance في المتصفح، دون أي شيفرة. يقبل Seedance 2.0 نصًا أو صورة مرجعية، ويعيد مقطعًا بحوار ومؤثرات صوتية وموسيقى تُولَّد في تمريرة واحدة. يدعم حتى تسع صور مرجعية وثلاثة فيديوهات مرجعية وثلاثة مقاطع صوتية، ويمكنك تثبيت الإطار الأول والأخير معًا.

للمسودات الأرخص يوجد Seedance 2.0 Fast وSeedance 2.0 Mini. وSeedance 2.5 Lite مصمم للحجم الكبير: يُنتج مقاطع من 5 أو 10 ثوانٍ مع صوت بدقة 480p أو 720p، ويستخدمه أعضاء Wonder دون حدود.

مسار PicassoIA API

تقدم PicassoIA أيضًا واجهة API للمطورين بنفس أسلوب Replicate: أنشئ تنبؤًا، ثم استعلم عن حالته، ثم اجلب النتيجة. عنوان URL الأساسي هو https://api.picassoia.com/v1، وتحمل الطلبات رمز وصول (bearer token) يبدأ بـ pia_sk_. يتوفر أربعة نماذج: الصور، ونموذج Image Editor Pro، والفيديو، ونموذج Seedance 2.5 Lite مع صوت متزامن.

تقول الوثائق "التنبؤات عبر API مجانية حاليًا. لا تستهلك أي نقاط." وتقول الصفحة نفسها "إنشاء التنبؤات يتطلب خطة Infinite." اقرأ السطرين معًا: مجاني لكل استدعاء، لكنه مقيّد بالخطة. تحقق من حسابك قبل أن تبني عليه. حدود يجب مراعاتها: خمسة تنبؤات تعمل في الوقت نفسه لكل حساب، و4,000 حرف لكل أمر نصي.

curl -X POST https://api.picassoia.com/v1/models/picassoia/seedance-2.5-lite/predictions \
  -H "Authorization: Bearer $PICASSOIA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "A potter shapes wet clay on a wheel, warm window light, slow push-in"}}'

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

تحمل الاستجابة معرّف تنبؤ. استعلم عن GET /v1/predictions/{id} حتى تصبح الحالة succeeded، ثم نزّل الفيديو من رابط المخرجات.

إليك مقارنة المسارات:

أي مسار يناسبك

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

كيف تستخدم Seedance 2.0 على PicassoIA

يستغرق سير العمل نحو خمس دقائق في المرة الأولى:

1. افتح النموذج. انتقل إلى صفحة Seedance 2.0 وسجّل الدخول.
2. اكتب الأمر النصي. موضوع واحد، وحركة واحدة، وحركة كاميرا واحدة، وملاحظة إضاءة واحدة. ضع الجمل المنطوقة بين علامتي اقتباس مزدوجتين حتى يولّد النموذج حوارًا.
3. اضبط المدة. استخدم 5 ثوانٍ للمسودات. القيمة -1 تترك للنموذج اختيار الطول من الأمر النصي.
4. اختر الدقة والنسبة. القيم الافتراضية هي 720p و16:9. انتقل إلى 9:16 للمنشورات العمودية.
5. أضف مراجع إن وُجدت. ارفع حتى تسع صور وأشر إليها باستخدام [Image1]، [Image2] في الأمر النصي. صورة الإطار الأول تحرّك لقطة ثابتة، لكنها لا تُدمج مع الصور المرجعية.
6. ولّد وقارن. غيّر إعدادًا واحدًا في كل تشغيل، حتى تعرف ما الذي أحدث الفرق.

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

صياغة مسودات الأوامر النصية بنموذج لغوي

وصف اللقطات أسهل بمساعدة. يعمل Claude Sonnet 5 وGemini 3.5 Flash كلاهما على PicassoIA. الصق فكرة أولية خام واطلب خمسة إصدارات بهذا الترتيب: الموضوع، والحركة، وحركة الكاميرا، والإضاءة، والصوت. ثم شغّل أفضل اثنتين عبر Seedance واحتفظ بالفائز.

أوامر نصية تعمل بشكل جيد

تتبع هذه الأوامر الأربعة الترتيب أعلاه. انسخها، ثم بدّل الموضوع:

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

ثلاثة أخطاء شائعة تهدر النقاط:

1. تكديس الحركات. خمس ثوانٍ تتسع لحركة واحدة واضحة، لا لمطاردة ومحادثة معًا.
2. إهمال الكاميرا. بدون ملاحظة عن الكاميرا يرتجل النموذج، وتتغير النتيجة في كل تشغيل.
3. تناقض الإضاءة. "غروب ذهبي داخل كهف مظلم" يعطي مخرجات باهتة. اختر مصدرًا واحدًا للضوء.

أنشئ أول مقطع لك اليوم

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

افتح PicassoIA، والصق أحد الأوامر أعلاه، وشاهد أول مقطع Seedance يُصيَّر أمامك. ثم جرّب الفكرة نفسها كصورة ثابتة وقارن بين الاثنتين. تصفّح كل نماذج الفيديو والصور والنماذج اللغوية على picassoia.com/en/all-models وابنِ سير عملك الخاص من هناك.