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-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
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 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
واجهة Wan 3.0 API
Wan 3.0 مع فلتر صارم
Wan Video v2.2 API
فيديو مفتوح الأوزان مع نسخة Lightning
Berry API
فيديو يبقى وفيًا لمراجعك
Blueberry API
ثبّت الإطار الأول والأخير
واجهة Cherry API
عائلة الفيديو الرائدة لدينا
Grok Video API
Grok Imagine في حالة حركة
الأسئلة الشائعة
الأسئلة الشائعة
كم تكلّف واجهة Seedance البرمجية؟
ما نقطة نهاية واجهة Seedance البرمجية؟
ما نماذج Seedance التي يمكنني استدعاؤها؟
هل يدعم Seedance الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Seedance من Claude أو ChatGPT؟
إلى متى تُحفظ نتائج Seedance؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.