Mage API · نموذج فيديو
Wan 3.0 API
Wan 3.0 مع فلتر صارم
POST https://api.mage.space/v1/wan_3/generateلمحة سريعة
تشغّل Wan 3.0 API النموذج Wan 3.0 عبر Mage على POST https://api.mage.space/v1/wan_3/generate. يكلّف الطلب بالإعدادات الافتراضية 245 Gems (نحو 0.245$) دون اشتراك. يقبل Wan 3.0 الشخصيات المحفوظة والمراجع والمراجع الصوتية عبر @handle في الوصف النصي.
- فيديوالمخرجات
- 1النسخة
- 245Gems لكل مقطع، افتراضيًا
- $0.245التكلفة التقريبية بالدولار
نظرة عامة
ماذا تقدّم Wan 3.0 API
نموذج Wan 3.0 الشامل من Alibaba. إطارا البداية والنهاية، وحتى 10 مراجع أو Characters، وVoices وصوت، ومقاطع من 2 إلى 30 ثانية بدقة تصل إلى 1080p. فلتر صارم: يُطبَّق فلتر المحتوى الخاص بالمزوّد.
نموذج Wan 3.0 من Alibaba، نموذج فيديو واحد للنصوص والإطارات والصور المرجعية والفيديوهات المرجعية وVoices، بمقاطع مدتها من 2 إلى 30 ثانية مع صوت مُولَّد. فلتر صارم: يفحص فلتر المحتوى لدى المزوّد النص الوصفي والوسائط المُدخلة والفيديو النهائي، وأي طلب يرفضه يفشل مع الرمز `content_blocked` وسبب الرفض، ويُستردّ المبلغ.
يقبل المدخلات first_image وlast_image وimage وadditional_images وvideos.
بداية سريعة
استدعاء Wan 3.0 API
عيّن MAGE_API_KEY، وأرسل الطلب إلى /wan_3/generate، ثم تابع status_url حتى يكتمل الطلب.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/wan_3/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": "3",
"model_id": "wan-3.0"
}' | 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('wan_3', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'wan-3.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("wan_3", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "wan-3.0",
})
print(request["result"]["url"])النماذج
قيم model_id في Wan 3.0
أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.
| model_id | الاسم | افتراضي |
|---|---|---|
| wan-3.0 | Wan 3.0 | نعم |
الخيارات
معاملات Wan 3.0
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 |
المدخلات
المدخلات الوسائطية التي يقبلها Wan 3.0
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| first_image | صورة الإطار الأول. |
| last_image | صورة الإطار الأخير. |
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
| videos | مقاطع الفيديو المصدر. |
القواعد
ما تفرضه Wan 3.0 API
- لا يمكن الجمع بين الإطارين الأول والأخير وبين الصور أو الفيديوهات المرجعية: أرسل نوعًا واحدًا فقط.
- حتى 10 صور مرجعية و5 فيديوهات مرجعية.
- مدة كل فيديو مرجعي من 1 إلى 15 ثانية، وبحد أقصى 15 ثانية للمجموع، ويجب ألا يتجاوز المجموع مع `duration` 30 ثانية. تُحتسب ثواني الفيديو المرجعي مثل ثواني المخرجات.
المزيد من نماذج الفيديو
واجهات برمجة أخرى لتوليد الفيديو على Mage
Wan Video v2.2 API
فيديو مفتوح الأوزان مع نسخة Lightning
Berry API
فيديو يبقى وفيًا لمراجعك
Blueberry API
ثبّت الإطار الأول والأخير
واجهة Cherry API
عائلة الفيديو الرائدة لدينا
Grok Video API
Grok Imagine في حالة حركة
Kiwi API
فيديو للاستخدام اليومي دون أي إعداد
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Wan 3.0 API؟
ما نقطة نهاية Wan 3.0 API؟
ما نماذج Wan 3.0 التي يمكنني استدعاؤها؟
هل يدعم Wan 3.0 صور المراجع أو الشخصيات؟
هل يمكنني استخدام Wan 3.0 من Claude أو ChatGPT؟
كم مدة الاحتفاظ بنتائج Wan 3.0؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.