لقد قرأت إعلان Seedance 2.5، وقمت برسم ميزة منتج حول مقاطع تم إنشاؤها مدتها 30 ثانية، والآن تريد كتابة التعليمات البرمجية. ثم تصطدم بالجدار الذي يصطدم به كل مطور بنموذج تم الإعلان عنه حديثًا: صفحة الإمكانات مباشرة، ولكن نقطة النهاية التي يمكنك استدعاؤها بالفعل من تطبيقك هي مسألة مختلفة تمامًا.
إليك النسخة الصادقة من الموقف، ودليل بدء سريع يحترمها. لقد نشرت Atlas Cloud صفحة عائلة Seedance 2.5 تلتزم بالوصول في اليوم الأول على نفس نقاط النهاية الموحدة التي تخدم بالفعل Seedance 2.0 و 1.5. في وقت كتابة هذا المقال، تم وضع علامة "قريبًا" على هذه القائمة ولم يتم نشر سعر Atlas Cloud لـ Seedance 2.5. ما يعنيه ذلك عمليًا هو أخبار جيدة: التكامل الذي تبنيه اليوم مقابل طبقة Seedance مباشرة هو نفس التكامل الذي ستشغله عند إطلاق 2.5. الشيء الوحيد الذي يتغير هو سلسلة النموذج.
لذلك يقوم دليل البدء السريع هذا بمهمتين. فهو يستخرج فيديو حقيقي من نقطة نهاية حقيقية اليوم، وينظم التعليمات البرمجية الخاصة بك ومطالباتك بحيث يكون الترقية عبارة عن فرق سطر واحد.
ما الذي يتم شحنه بالفعل في Seedance 2.5
وفقًا لصفحة Seedance 2.5 الرسمية لـ ByteDance، هذا نموذج جيل مشترك للصوت والفيديو من الجيل التالي تم بناؤه لسرد القصص لمدة 30 ثانية مع تحكم دقيق في المرجع وتحرير قوي. المطالبات الملموسة التي تستحق التصميم حولها:
- ما يصل إلى 30 ثانية في جيل واحد، مع خيار التمديد مرتين لسرد قصص أطول وأكثر اكتمالاً
- حركة أكثر سلاسة واتساقًا، مع صور أكثر واقعية
- فهم أكثر دقة للفيديو المرجعي، والتقاط النية والإطار واللغة السينمائية بدلاً من مجرد نقل الحركة
- تحرير أكثر موثوقية عبر مجموعة واسعة من طلبات التحرير الصوتية والمرئية
- التحكم في النموذج الأبيض والتحرير على الشاشة الخضراء، بالإضافة إلى حركة الكاميرا الاحترافية وحظر الأداء، بهدف سير عمل الإنتاج المعقد
لاحظ ما ليس في تلك القائمة: لا يوجد جدول مقارنة، ولا سلم دقة، ولا عدد أصول مرجعية. أي شيء رأيته على هذا المنوال هو تلميع تسويقي لشخص ما، وليس ورقة مواصفات الطرف الأول. ابنِ على المطالبات المذكورة أعلاه.
الخطوة 1: احصل على مفتاح من وحدة التحكم
سجل الدخول إلى console.atlascloud.ai وأنشئ مفتاح API. لا يوجد إيداع، ولا التزام أدنى، ولا قائمة انتظار، لذا فإن المفتاح قابل للاستخدام فورًا على أساس الدفع حسب الاستخدام. يغطي مفتاح واحد الكتالوج الكامل لأكثر من 300 نموذج عبر النص والصورة والفيديو، على حساب فوترة واحد، وهو الجزء المهم لهذا الدليل السريع: المفتاح الذي تقوم بإنشائه الآن هو نفس المفتاح الذي سيستدعي Seedance 2.5.
قم بتخزينه كمتغير بيئة، وليس في المصدر أبدًا. ATLASCLOUD_API_KEY اسم جيد.
الخطوة 2: إرسال مهمة فيديو
إنشاء الفيديو على Atlas Cloud هو استدعاء REST غير متزامن من خطوتين، وليس إكمال دردشة. تقوم بإرسال مهمة وتحصل على معرف تنبؤ، ثم تستعلم عن هذا المعرف حتى ينتهي العرض. أي عميل HTTP سيفي بالغرض، لذلك لا يوجد SDK للمورد لتثبيته ولا مخطط مصادقة جديد لتعلمه: إنه رمز حامل على المفتاح الذي قمت بإنشائه للتو.
python1import os, time, requests 2 3KEY = os.environ["ATLASCLOUD_API_KEY"] 4BASE = "https://api.atlascloud.ai/api/v1/model" 5HAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"} 6 7job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={ 8 "model": "bytedance/seedance-2.0/text-to-video", 9 "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, " 10 "neon reflections on wet asphalt, slight lag on turns.", 11 "duration": 5, 12 "resolution": "720p", 13 "ratio": "adaptive", 14 "bitrate_mode": "standard", 15 "generate_audio": True, 16 "watermark": False, 17}).json() 18 19prediction_id = job["data"]["id"]
يأتي الرد على شكل {"code": 200, "data": {"id": "...", "status": "processing"}}. لاحظ أن model هو حقل سلسلة عادي. هذه التفاصيل هي قصة الترقية بأكملها لهذا المقال، والخطوة 6 تعود إليها.
الخطوة 3: استعلم حتى يتم الانتهاء من العرض
مقطع مدته 5 ثوانٍ ليس استجابة فورية، لذا تعامل مع العرض كمهمة ذات دورة حياة بدلاً من استدعاء حظر. استعلم عن نقطة نهاية التنبؤ حتى يصل status إلى قيمة نهائية.
python1while True: 2 r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json() 3 status = r["data"]["status"] 4 if status in ("completed", "succeeded", "failed"): 5 break 6 time.sleep(3) 7 8print(status, r["data"]) # on success the payload carries the output URL(s)
شيئان يستحقان البناء الآن بدلاً من لاحقًا. ضع سقفًا لحلقة الاستعلام حتى لا تتمكن مهمة عالقة من تعليق معالج الطلب، واحتفظ بمعرف التنبؤ قبل أن تبدأ الاستعلام حتى يتمكن العامل المتعطل من الاستئناف بدلاً من الدفع مقابل العرض مرتين. كلتا العادتين تنتقلان دون تغيير إلى 2.5.
إذا كانت ميزتك تعمل من صورة مرجعية أو مرجع موضوع بدلاً من النص الخالص، فإن نفس التدفق ينطبق مع متغير نموذج مختلف، bytedance/seedance-2.0/image-to-video أو bytedance/seedance-2.0/reference-to-video. يتم تحميل أصول مرجع الموضوع مرة واحدة من خلال uploadMedia ثم يتم تمريرها كـ asset://<id> في حقول الصورة، لذلك لا تحتاج شخصية أو منتج متكرر إلى إعادة التحميل في كل استدعاء.
الخطوة 4: اختر طبقة Seedance مباشرة واعرف تكلفة الثانية
تفرض Atlas Cloud رسومًا على الفيديو لكل ثانية من مدة الإخراج. هذا حساب يمكنك القيام به في ذهنك قبل كتابة أي رمز. ثلاث طبقات Seedance مباشرة اليوم:
| النموذج | معرف النموذج | سعر Atlas Cloud | ملاحظة |
|---|---|---|---|
| Seedance 2.0 | bytedance/seedance-2.0/text-to-video | 0.112 دولار/ثانية | الطبقة الرئيسية المباشرة، مفتاح فوري، لا توجد قائمة انتظار |
| Seedance 2.0 Fast | bytedance/seedance-2.0-fast/text-to-video | 0.09 دولار/ثانية | متغير أسرع من نفس العائلة |
| Seedance 2.0 Mini | bytedance/seedance-2.0-mini/text-to-video | 0.056 دولار/ثانية | أرخص طبقة Seedance 2.0 مباشرة، أيضًا تحويل الصورة إلى فيديو وتحويل المرجع إلى فيديو |
| Seedance 1.5 Pro | bytedance/seedance-v1.5-pro/text-to-video | 0.047 دولار/ثانية، أو 0.018 دولار/ثانية على المتغير السريع | صوت متزامن أصلي، مزامنة شفاه متعددة اللغات، مقاطع من 4 إلى 12 ثانية |
للتوجيه، تعمل نماذج الفيديو الأخرى على نفس المفتاح في نطاق مماثل: Grok Imagine Video v1.5 بسعر 0.080 دولار/ثانية، Wan 2.7 بسعر 0.100 دولار/ثانية، Kling V3.0 Turbo بسعر 0.112 دولار قياسي و 0.095 دولار مخفض، MiniMax H3 بسعر 0.14 دولار/ثانية.
يعتمد النموذج الذي ستبني عليه على ما ستقوم به ميزة 2.5 في النهاية. إذا كان الصوت أساسيًا للإخراج، فإن Seedance 1.5 Pro هي الطبقة التي تحتوي بالفعل على صوت متزامن أصلي ومزامنة شفاه متعددة اللغات، لذلك يتعلم خط الأنابيب الخاص بك التعامل مع مسار صوتي من اليوم الأول. إذا كنت تكرر بنية المطالبة وتريد أقل تكلفة لكل تجربة، فإن Seedance 2.0 Mini بسعر 0.056 دولار/ثانية هو صندوق الرمل الواضح. إذا كنت تريد أقرب شيء إلى عرض من الجيل الحالي بجودة إنتاج، فإن Seedance 2.0 بسعر 0.112 دولار/ثانية هو الخيار المباشر، مع المتغير السريع بسعر 0.09 دولار/ثانية إذا كانت الإنتاجية أهم من الزيادة الأخيرة في الجودة.
الخطوة 5: تحقق من السعر المباشر في Playground قبل أن تنفق
قبل أول مكالمة مدفوعة، افتح النموذج في Atlas Cloud Playground. يعرض كل نموذج سعره المباشر لكل نموذج بجوار زر التشغيل. هذا أكثر أهمية مما يبدو: الخصومات الترويجية تأتي وتذهب، والرقم بجوار زر التشغيل هو الذي سيتم فوترته بالفعل. قم بتشغيل جيل واحد في Playground، وتأكد من أن الإخراج هو ما تحتاجه ميزتك، ثم انقل الإعدادات إلى التعليمات البرمجية.
نموذج الدفع لكل ثانية على الإخراج يجعل محادثة ميزانيتك تافهة. مقطع مدته 10 ثوانٍ على Seedance 2.0 Mini هو 10 × 0.056 دولار. لا يوجد آلة حاسبة، ولا تقدير للرموز، ولا خطوة تسوية لاحقة.
يستحق هذا التباين مع كيفية فوترة قنوات ByteDance للطرف الأول لـ Seedance. على Volcano Engine Ark في الصين و BytePlus ModelArk دوليًا، تعتمد الفوترة على الرموز: استهلاك الرموز المقدر هو (مدة الفيديو المدخلة + مدة الفيديو المخرجة) × عرض الإخراج × ارتفاع الإخراج × معدل إطارات الإخراج / 1024، مضروبًا في سعر وحدة الرمز، مع الاستخدام الفعلي الموثوق به من حقل usage.completion_tokens في استجابة API. بالنسبة لسلسلة Seedance 2.0 و Seedance 2.5، عندما يتضمن الإدخال فيديو، يتم تطبيق حد أدنى لاستهلاك الرموز، ويعتمد الحد الأدنى على الدقة ونسبة العرض إلى الارتفاع ومدة الإخراج. تنشر ByteDance حاسبة تسعير بالإضافة إلى جدول الحد الأدنى للرموز لهذا السبب بالضبط.
كلا النموذجين شرعيان. ولكن إذا كنت تضع ميزانية لعرض مدته 30 ثانية، فإن مدة الدفع لكل ثانية على الإخراج هي حساب ذهني، وتتطلب الرموز ذات الحدود الدنيا جدول بيانات.
الخطوة 6: اكتب وصف اللقطة كما لو كانت 2.5 بالفعل
هذا هو الجزء من دليل البدء السريع الذي ينتقل بشكل مثالي، لأن صياغة المطالبات ليست ذات إصدار. اثنان من مطالبات إمكانات 2.5 يجب أن يغيرا طريقة كتابتك اليوم.
تحكم دقيق في المرجع. تدعي ByteDance أن 2.5 يقرأ فيديو مرجعيًا لنيته وإطاره ولغته السينمائية، متجاوزًا نقل الحركة. يعني ذلك ضمنيًا أن أصلك المرجعي يتوقف عن كونه قالب حركة ويبدأ في أن يكون موجزًا إخراجيًا. لذا توقف عن كتابة المطالبات التي تصف الموضوع فقط، وابدأ في تسمية القواعد النحوية التي تريد نقلها: إحساس العدسة، والإطار، وسرعة القطع، وما إذا كانت الكاميرا تقود أو تتبع الموضوع. اكتب "لقطة متوسطة محمولة باليد تتبع الموضوع، انعكاسات نيون على الأسفلت الرطب، تأخر طفيف عند المنعطفات" بدلاً من "شخص يمشي، سينمائي".
ثلاثون ثانية في جيل واحد. مقطع مدته 5 ثوانٍ هو لقطة واحدة. ثلاثون ثانية هي مشهد ذو بنية، و 2.5 يدعم التمديد مرتين فوق ذلك. لذا اكتب أوصاف اللقطات ببنية إيقاعية بدلاً من وصف ثابت واحد: إيقاع تأسيسي، تغيير (منعطف، مدخل، كشف)، وحل. سمِّ حركة الكاميرا وحظر الأداء صراحةً، لأن هذه هي بالضبط الضوابط التي تستهدفها 2.5. أين يقف الموضوع، وأين يتحرك، وماذا تفعل الكاميرا أثناء تحركه.
كلتا العادتين تؤتي ثمارهما في الطبقات المباشرة الآن. كلاهما العادات الدقيقة التي تكافئها 2.5.
الخطوة 7: خطط للتبديل
قم ببناء التعليمات البرمجية الخاصة بك بحيث يكون معرف النموذج هو التكوين، وليس حرفيًا. ثابت واحد، يتم قراءته من البيئة أو التكوين:
python1SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
ثم مرر SEEDANCE_MODEL حيث قامت الخطوة 2 بتشفير السلسلة. نظرًا لأن model هو حقل سلسلة JSON واحد في نص generateVideo، فإن الترقية عند إطلاق 2.5 هي حقًا متغير بيئة واحد. ليس استعارة لتغيير صغير، بل قيمة واحدة حرفيًا.
لا تقم أبدًا بتشفير معرف Seedance 2.5 اليوم، لأنه لا يوجد معرف نموذج Atlas Cloud Seedance 2.5 حتى الآن. اسحب المعرفات المباشرة الدقيقة من الكتالوج على atlascloud.ai/models بدلاً من نسخها من مقال، بما في ذلك هذا المقال، حيث يتم إضافة متغيرات جديدة بمرور الوقت. عندما يصل 2.5 بموجب التزام اليوم الأول، فإن العمل من جانبك هو هذا المتغير الواحد، بالإضافة إلى نظرة جديدة على السعر بجوار زر التشغيل وإعادة قراءة أي معلمات طلب جديدة، حيث من المحتمل أن يقبل نموذج 30 ثانية مع دعم التمديد حقولًا لا يحتوي عليها نص 2.0.
في غضون ذلك، إذا كنت بحاجة إلى Seedance 2.5 اليوم بدلاً من إطلاقه على Atlas Cloud، فإن الإجابة الصادقة هي قنوات ByteDance للطرف الأول: Volcano Engine Ark في الصين و BytePlus ModelArk دوليًا. من بين المجمعات، العديد منها في نفس حالة ما قبل الإطلاق أو التزام اليوم الأول.
الأسئلة الشائعة
س: هل يمكنني استدعاء Seedance 2.5 على Atlas Cloud الآن؟ ج: لا. تم وضع علامة "قريبًا" على صفحة عائلة Seedance 2.5 على Atlas Cloud مع التزام بالوصول في اليوم الأول على نفس نقاط النهاية الموحدة التي تخدم بالفعل Seedance 2.0 و 1.5. لم يتم نشر معرف نموذج ولا سعر له بعد.
س: ما هي تكلفة Seedance على Atlas Cloud اليوم؟ ج: Seedance 2.0 بسعر 0.112 دولار/ثانية، Seedance 2.0 Fast بسعر 0.09 دولار/ثانية، Seedance 2.0 Mini بسعر 0.056 دولار/ثانية، و Seedance 1.5 Pro بسعر 0.047 دولار/ثانية أو 0.018 دولار/ثانية على متغيره السريع. تتم الفوترة لكل ثانية من مدة الإخراج، ويتم عرض السعر المباشر بجوار زر التشغيل في Playground.
س: هل أحتاج إلى SDK خاص للفيديو على Atlas Cloud؟
ج: لا. الفيديو هو تدفق REST عادي: POST /api/v1/model/generateVideo لإرسال مهمة، ثم GET /api/v1/model/prediction/{id} للاستعلام عنها، وكلاهما مصادق عليه برمز حامل على مفتاح Atlas Cloud الخاص بك. يعمل أي عميل HTTP. لاحظ أن الفيديو لا يمر عبر نقطة نهاية الدردشة المتوافقة مع OpenAI التي يستخدمها كتالوج النص، لذا لا تتوقع أن يقوم chat.completions بعرض مقطع. يتم توثيق معلمات الطلب لكل نموذج على atlascloud.ai/docs.
س: هل يوجد إيداع أو التزام أدنى للبدء؟ ج: لا. Atlas Cloud هو نظام دفع حسب الاستخدام بدون إيداع، ولا التزام أدنى، ولا قائمة انتظار، والمفتاح من console.atlascloud.ai قابل للاستخدام فورًا.
س: أي طبقة مباشرة يجب أن أستخدمها للنموذج الأولي إذا كنت أستهدف 2.5؟ ج: Seedance 2.0 Mini بسعر 0.056 دولار/ثانية لتكرار المطالبات الرخيص، Seedance 1.5 Pro إذا كان خط الأنابيب الخاص بك يحتاج إلى التعامل مع مسار صوتي متزامن أصلي، و Seedance 2.0 بسعر 0.112 دولار/ثانية لأقرب عرض إنتاج من الجيل الحالي.
الخلاصة
تدير Atlas Cloud Seedance 2.0، Seedance 2.0 Fast، Seedance 2.0 Mini و Seedance 1.5 Pro اليوم على مفتاح API واحد مع فوترة لكل ثانية على مدة الإخراج، وشهادة SOC II، والامتثال لـ HIPAA والتشفير في حالة السكون وأثناء النقل، وقد نشرت التزامًا بالوصول في اليوم الأول لخدمة Seedance 2.5 على نفس نقاط النهاية الموحدة عند شحنها.
