أُطلق وضع العيّنة لـ Seedance 2.5 على APIYI: شرح استدعاء لتحويل عيّنة بدقة 480p إلى فيديو نهائي بدقة 1080p في خطوتين

ملاحظة المؤلف: يشرح هذا المقال آلية الاستدعاء على مرحلتين في وضع المعاينة من Seedance 2.5. ابدأ بإنشاء معاينة بدقة 480p وبتكلفة منخفضة، ثم أنشئ النسخة النهائية بدقة 1080p بعد التأكد من النتيجة. يتضمن المقال أمثلة للطلبات جاهزة للتشغيل.

عند إنشاء فيديوهات بالذكاء الاصطناعي، من أكثر المشكلات شيوعًا البدء مباشرةً بإنتاج النسخة النهائية عالية الدقة، ثم اكتشاف أن التكوين أو حركة الكاميرا أو حركة العناصر الرئيسية غير مرضية، ما يضطرك إلى إعادة التوليد وإهدار الوقت والتكلفة. في 25 أكتوبر 2026، أضافت وثائق APIYI شرحًا كاملًا لطريقة استدعاء وضع المعاينة في Seedance 2.5 (Draft Mode). يتيح لك هذا الوضع التحقق من فكرتك أولًا باستخدام معاينة بدقة 480p، ثم إنشاء النسخة النهائية بدقة 1080p بالاستناد إلى معرّف مهمة المعاينة بعد التأكد من ملاءمتها.

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

الفائدة الأساسية: بعد قراءة هذا المقال، ستتعرف على سير عمل الاستدعاء على مرحلتين في وضع المعاينة من Seedance 2.5، ومعلماته الأساسية، وقواعد الفوترة، وقيود الاستخدام، وستتمكن من دمج سير عمل «معاينة أولًا، ثم إنتاج النسخة النهائية» في مسار إنتاج الفيديو الخاص بك.

النقاط الأساسية في وضع النسخة التجريبية من Seedance 2.5

وفقًا لما يوضحه مركز توثيق APIYI، يمكن تلخيص المعلومات الأساسية عن وضع النسخة التجريبية من Seedance 2.5 في الجدول التالي:

لماذا يستحق وضع النسخة التجريبية من Seedance 2.5 الاستخدام؟

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

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

العلاقة بين مرحلتي وضع النسخة التجريبية من Seedance 2.5

تجدر الإشارة إلى أن النسخة النهائية ليست مجرد تكبير للنسخة التجريبية. فالمرحلة الثانية مهمة توليد جديدة، تشير إلى مهمة النسخة التجريبية عبر draft_task.id، وترث الإعدادات ذات الصلة من مرحلتها، ثم تُخرج النتيجة بدقة 1080p. لمعرفة المعلمات التي تُورَّث وتلك التي لا يمكن تعديلها في المرحلة الثانية، راجع قسم «وراثة المعلمات والقيود» في وثائق APIYI.

بدء سريع باستخدام وضع العيّنة في Seedance 2.5

قبل البدء، أنشئ مفتاح API في لوحة تحكم APIYI على apiyi.com، ثم عيّنه في متغير البيئة APIYI_API_KEY. تقرأ جميع الأمثلة أدناه المفتاح من متغير البيئة، لتجنب تضمينه في الشفرة.

الخطوة الأولى: إنشاء عيّنة بدقة 480p

فيما يلي أبسط طلب لإنشاء مهمة عيّنة. المفتاح هو تعيين "draft": true وضبط الدقة على 480p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进"}
    ],
    "draft": true,
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": false
  }'

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

شرح معلمات الطلب في الخطوة الأولى

يُستخدم Accept-Encoding: identity في ترويسة الطلب لطلب عدم ضغط الاستجابة من جهة الخادم، ما يسهّل على بعض العملاء تحليل النتيجة مباشرة. يُنصح بالإبقاء عليه.

الخطوة الثانية: الاستعلام عن حالة مهمة المعاينة

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

curl -X GET "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/${TASK_ID}" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Accept-Encoding: identity"

يُنصح بضبط الفاصل بين عمليات الاستعلام على 5 إلى 10 ثوانٍ. فالاستعلام بوتيرة أعلى لا يفيد، بل قد يؤدي إلى تفعيل حدود معدل الطلبات.

الخطوة الثالثة: إنشاء الفيديو النهائي بدقة 1080p باستخدام معرّف مهمة المعاينة

بعد التأكد من رضاك عن نتيجة المعاينة، أدرج مرجعًا إلى مهمة المعاينة عبر draft_task.id في مصفوفة content، واضبط الدقة على 1080p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "YOUR_DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

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

import os
import time
import requests

API_KEY = os.environ["APIYI_API_KEY"]
BASE_URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"  # واجهة مهام Seedance غير المتزامنة في APIYI
MODEL = "doubao-seedance-2-5-260628"

HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Accept-Encoding": "identity",
}


def create_task(payload: dict) -> str:
    """إنشاء مهمة غير متزامنة وإرجاع معرّفها"""
    resp = requests.post(BASE_URL, headers=HEADERS, json=payload, timeout=60)
    resp.raise_for_status()
    data = resp.json()
    return data["id"]


def wait_task(task_id: str, interval: int = 8, timeout: int = 900) -> dict:
    """الاستعلام عن حالة المهمة حتى تنجح أو تفشل"""
    start = time.time()
    while time.time() - start < timeout:
        resp = requests.get(f"{BASE_URL}/{task_id}", headers=HEADERS, timeout=30)
        resp.raise_for_status()
        data = resp.json()
        status = data.get("status")
        print(f"[{task_id}] status = {status}")
        if status == "succeeded":
            return data
        if status in ("failed", "cancelled", "expired"):
            raise RuntimeError(f"انتهت المهمة دون نجاح: {data}")
        time.sleep(interval)
    raise TimeoutError(f"انتهت مهلة الاستعلام عن المهمة {task_id}")


def generate_draft(prompt: str) -> str:
    """المرحلة الأولى: إنشاء عينة بدقة 480p"""
    payload = {
        "model": MODEL,
        "content": [{"type": "text", "text": prompt}],
        "draft": True,
        "resolution": "480p",
        "ratio": "16:9",
        "duration": 4,
        "generate_audio": False,
    }
    task_id = create_task(payload)
    result = wait_task(task_id)
    print("نتيجة العينة:", result.get("content"))
    return task_id


def generate_final(draft_task_id: str) -> dict:
    """المرحلة الثانية: إنشاء النسخة النهائية بدقة 1080p باستخدام معرّف مهمة العينة"""
    payload = {
        "model": MODEL,
        "content": [
            {"type": "draft_task", "draft_task": {"id": draft_task_id}}
        ],
        "resolution": "1080p",
    }
    task_id = create_task(payload)
    return wait_task(task_id)


if __name__ == "__main__":
    draft_id = generate_draft("一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进")
    ok = input("样片是否满意？(y/n): ").strip().lower()
    if ok == "y":
        final = generate_final(draft_id)
        print("成片结果:", final.get("content"))
    else:
        print("请调整提示词后重新生成样片。")

🚀 ابدأ بسرعة: يُنصح بالحصول على رصيد الاختبار المجاني للمستخدمين الجدد من APIYI على apiyi.com، ثم تحسين الموجه باستخدام عينة بدقة 480p قبل إنشاء النسخ النهائية بدقة 1080p على دفعات. تستخدم المنصة مفتاح API موحدًا للفوترة، ما يسهّل إدارة تكاليف استدعاء النماذج لمشروعات الفيديو المختلفة.

مقارنة بين وضع العيّنة والإنتاج المباشر للفيديو النهائي في Seedance 2.5

يعتمد اختيار استخدام وضع العيّنة على متطلبات عملك من حيث ضمان النتيجة وسرعة التسليم. يقارن الجدول أدناه بين طريقتَي الاستدعاء:

قراءة مقارنة وضع العيّنة في Seedance 2.5

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

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

💡 اقتراح للاختيار: لمعرفة الفرق الفعلي بين الطريقتين، جرّب عدة مجموعات من الموجهات الخاصة بعملك وقارن النتائج. عند الاستدعاء عبر APIYI apiyi.com، تستخدم الطريقتان الواجهة ومفتاح API نفسيهما؛ ولا يتطلب التبديل سوى تعديل معلمات جسم الطلب.

ملاحظات عند دمج وضع المقاطع التجريبية في Seedance 2.5

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

اقتراحات لتصميم سير عمل وضع المقاطع التجريبية في Seedance 2.5

في سيناريوهات العمل الجماعي، يُفضّل تقسيم وضع المقاطع التجريبية إلى ثلاث مراحل: «إنشاء — مراجعة — اعتماد». بعد أن ينشئ النظام المقاطع التجريبية على دفعات، يرسلها إلى المراجعين. وتُضاف معرّفات المهام للمقاطع التي اجتازت المراجعة إلى قائمة انتظار إنشاء النسخ النهائية، بينما تعود المقاطع المرفوضة، مصحوبة بملاحظات التعديل، إلى مرحلة تعديل الموجه. بهذه الطريقة، يتركز التقييم البشري في مرحلة المقاطع التجريبية منخفضة التكلفة.

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

الأسئلة الشائعة

أبرز النقاط حول نمط العينة في Seedance 2.5

• عملية من مرحلتين: أنشئ أولًا عينة بدقة 480p باستخدام draft: true، ثم استخدم معرّف المهمة لإنتاج فيديو نهائي بدقة 1080p
• الواجهة لم تتغير: تعتمد العملية على واجهة المهام غير المتزامنة الحالية في Seedance، لذا لا تتطلب المشاريع المتصلة بها سوى تعديلات بسيطة
• الحقل الأساسي: يُشار إلى مهمة العينة في مرحلة إنتاج الفيديو النهائي عبر content[].draft_task.id
• آلية الفوترة: تُحتسب تكلفة العينة والفيديو النهائي كلٌّ على حدة؛ ولا تدفع تكلفة الفيديو النهائي إلا للعينة التي تنال رضاك
• قيود المدة: تظل معرّفات مهام العينة صالحة لمدة 7 أيام، لذا راجعها واعتمدها في الوقت المناسب
• حالات الاستخدام: تظهر الفائدة بوضوح في استكشاف الأفكار، وموافقة العملاء، وفرز المواد على نطاق واسع
• طريقة البدء: احصل على رصيد مجاني من APIYI apiyi.com، واستخدم أمثلة هذه المقالة لتجربة العملية كاملةً

الخلاصة

أهم النقاط المتعلقة بوضع العينات في Seedance 2.5:

1. اختبر قبل الإنتاج: تحقّق من التكوين وحركة الكاميرا بتكلفة منخفضة باستخدام عينات بدقة 480p، لتقليل نسبة المقاطع غير الصالحة بدقة 1080p.
2. سهولة الدمج: أضف المَعلمة draft وأشِر إلى draft_task.id، مع إعادة استخدام واجهة الطلبات غير المتزامنة الحالية.
3. انتبه إلى الصلاحية والفوترة: تظل معرّفات العينات صالحة لمدة 7 أيام، وتُحتسب رسوم العينات والمقاطع النهائية كلٌّ على حدة.

إذا كان نشاطك في مجال الفيديو يتطلب تعديل الموجّهات مرارًا، فمن المفيد دمج وضع العينات في أقرب وقت. ابدأ بتجربة مجموعة من الموجّهات النموذجية عبر سير العمل «عينة ← مقطع نهائي»، ثم قيّم النتائج والتكلفة قبل تعميمه على الإنتاج بالجملة.

نوصي باستخدام APIYI apiyi.com لاختبار الأثر العملي لوضع العينات في Seedance 2.5 بسرعة. توفّر المنصة واجهة متوافقة مع OpenAI، وفوترة حسب الاستخدام، ورصيدًا مجانيًا للاختبار للمستخدمين الجدد.

📚 المراجع

1. وثائق APIYI لتوليد الفيديو باستخدام Seedance 2 – وضع العينات: تعليمات الاستخدام الرسمية لوضع العينات في Seedance 2.5
2. الرابط: docs.apiyi.com/api-capabilities/seedance2/video-generation#draft-mode

3. التفاصيل: تتضمن أمثلة للطلبات في المرحلتين، وشرحًا لتوارث المَعلمات والقيود، إضافة إلى الفوترة ومدة الصلاحية.

4. مركز وثائق APIYI: وثائق واجهات جميع النماذج المتاحة على المنصة

5. الرابط: docs.apiyi.com
6. التفاصيل: يمكنك الاطلاع على نظرة عامة لاختيار نماذج Seedance وطرق استدعاء النماذج الأخرى.

المؤلف: فريق APIYI التقني
للتواصل التقني: إذا واجهت أي مشكلة أثناء الدمج، يُرجى التواصل معنا عبر الصفحة الرئيسية لموقع APIYI apiyi.com. ولمزيد من المعلومات، تفضّل بزيارة مركز الوثائق docs.apiyi.com.

مقالات ذات صلة

• تطبيق عملي على SeeDance2.5 لتوليد الفيديوهات وتحريرها بوجوه: 3 خطوات لإضافة مواد أشخاص حقيقيين إلى المكتبة واستدعائها بشكل متوافق مع اللوائح: اشرح المسار الصحيح لتوليد الفيديوهات وتحريرها باستخدام الوجوه في SeeDance2.5: أضف مواد الأشخاص الحقيقيين إلى المكتبة، واحصل على معرّف الأصل (Asset ID)، واستدعِها باستخدام مرجع asset://، مع توضيح ما إذا كان إخفاء الوجه ضروريًا ولماذا يُحظر رفع فيديوهات الوجوه مباشرةً.