انتقل إلى المحتوى

Mage API · نموذج فيديو

واجهة Seedance البرمجية

Seedance، مع فلتر صارم

POST https://api.mage.space/v1/seedance/generate

لمحة سريعة

تشغّل واجهة Seedance البرمجية نموذج Seedance 2.5 و3 نماذج أخرى عبر Mage على POST https://api.mage.space/v1/seedance/generate. يكلّف الطلب بالإعدادات الافتراضية 618 Gems (نحو $0.618) دون اشتراك. يقبل Seedance الشخصيات المحفوظة والمراجع والمراجع الصوتية عبر @handle في الوصف النصي.

  • فيديوالمخرجات
  • 4الإصدارات
  • 618Gems لكل مقطع، افتراضيًا
  • $0.618التكلفة التقريبية بالدولار

نظرة عامة

ماذا تقدّم واجهة Seedance البرمجية

Seedance من ByteDance، من Seedance 2.0 Mini للمسوّدات إلى Seedance 2.5، مع مقاطع حتى 30 ثانية، ومراجع أو Characters متعددة، وتعديلات على فيديو مصدر. فلتر صارم: يُطبَّق فلتر المحتوى الخاص بالمزوّد.

سلسلة Seedance للفيديو من ByteDance، بحركة سينمائية وصوت: Seedance 2.0 Mini وSeedance 2.0 Fast وSeedance 2.0 وSeedance 2.5، وهو الأقوى، بمقاطع تصل مدتها إلى 30 ثانية. فلتر صارم: يفحص فلتر المحتوى لدى المزوّد النص الوصفي والوسائط المُدخلة والفيديو النهائي، وأي طلب يرفضه يفشل مع الرمز `content_blocked` وسبب الرفض، ويُستردّ المبلغ.

تقبل المدخلات image وadditional_images وvideos.

بداية سريعة

استدعاء واجهة Seedance البرمجية

عيّن MAGE_API_KEY، وأرسل الطلب إلى /seedance/generate، ثم تابع status_url حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedance/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "4",
  "model_id": "seedance-2.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedance', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'seedance-2.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedance", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "seedance-2.5",
})

print(request["result"]["url"])

النماذج

قيم model_id في Seedance

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
seedance-2.0-miniSeedance 2.0 Mini
seedance-2.0-fastSeedance 2.0 Fast
seedance-2.0Seedance 2.0
seedance-2.5Seedance 2.5نعم

الخيارات

معاملات Seedance

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

المدخلات

المدخلات الوسائطية التي يقبلها Seedance

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.
videosمقاطع الفيديو المصدر.

القواعد

القواعد التي تفرضها واجهة Seedance البرمجية

  • يتطلب تعديل الفيديو فيديو مصدر واحدًا بالضبط، مدته من 4 إلى 30 ثانية في `seedance-2.5` ومن 2 إلى 15 ثانية في النماذج الأخرى.
  • في `seedance-2.5` يحتفظ التعديل بمدة الفيديو المصدر ونسبة أبعاده: يتم تجاهل `duration` و`aspect_ratio`، ويتبع السعر مدة الفيديو.

المزيد من نماذج الفيديو

واجهات برمجة أخرى لتوليد الفيديو على Mage

  • فيديو · من 245 Gems

    واجهة Wan 3.0 API

    Wan 3.0 مع فلتر صارم

  • فيديو · من 40 Gems

    Wan Video v2.2 API

    فيديو مفتوح الأوزان مع نسخة Lightning

  • فيديو · من 189 Gems

    Berry API

    فيديو يبقى وفيًا لمراجعك

  • فيديو · من 360 Gems

    Blueberry API

    ثبّت الإطار الأول والأخير

  • فيديو · من 618 Gems

    واجهة Cherry API

    عائلة الفيديو الرائدة لدينا

  • فيديو · من 375 Gems

    Grok Video API

    Grok Imagine في حالة حركة

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

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

كم تكلّف واجهة Seedance البرمجية؟
يكلّف طلب Seedance بالإعدادات الافتراضية (Seedance 2.5) ‏618 Gems، أي نحو $0.618. تغيّر الدقة والمدة والنسخة السعر؛ وتعرض الاستجابة المبلغ المحتسب بدقة. تُسترجع تكلفة عملية التوليد الفاشلة، أما ما تحجبه سياسة المحتوى في Mage فلا تُسترجع تكلفته.
ما نقطة نهاية واجهة Seedance البرمجية؟
أرسل POST إلى https://api.mage.space/v1/seedance/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url لمتابعة النتيجة.
ما نماذج Seedance التي يمكنني استدعاؤها؟
seedance-2.0-mini (‏Seedance 2.0 Mini)، وseedance-2.0-fast (‏Seedance 2.0 Fast)، وseedance-2.0 (‏Seedance 2.0)، وseedance-2.5 (‏Seedance 2.5). النموذج الافتراضي هو Seedance 2.5.
هل يدعم Seedance الصور المرجعية أو الشخصيات؟
يقبل Seedance الحقول image وadditional_images وvideos. ويقبل الشخصيات المحفوظة والمراجع والمراجع الصوتية عبر @handle في الوصف النصي.
هل يمكنني استخدام Seedance من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP مع Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Seedance بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
إلى متى تُحفظ نتائج Seedance؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.