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

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.0Wan 3.0نعم

الخيارات

معاملات Wan 3.0

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

الحقلالقيم
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration2, 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

  • فيديو · من 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 في حالة حركة

  • فيديو · من 270 Gems

    Kiwi API

    فيديو للاستخدام اليومي دون أي إعداد

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

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

كم تبلغ تكلفة Wan 3.0 API؟
يكلّف طلب Wan 3.0 بالإعدادات الافتراضية (Wan 3.0) ‏245 Gems، أي نحو 0.245$. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتذكر الاستجابة المبلغ المحتسب بدقة. تُسترد تكلفة عملية التوليد الفاشلة، أما ما تحظره سياسة المحتوى في Mage فلا تُسترد تكلفته.
ما نقطة نهاية Wan 3.0 API؟
أرسل POST إلى https://api.mage.space/v1/wan_3/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url لمتابعة النتيجة.
ما نماذج Wan 3.0 التي يمكنني استدعاؤها؟
wan-3.0 (Wan 3.0). النموذج الافتراضي هو Wan 3.0.
هل يدعم Wan 3.0 صور المراجع أو الشخصيات؟
يقبل Wan 3.0 الحقول first_image وlast_image وimage وadditional_images وvideos. كما يقبل الشخصيات المحفوظة والمراجع والمراجع الصوتية عبر @handle في الوصف النصي.
هل يمكنني استخدام Wan 3.0 من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP مع Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Wan 3.0 بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
كم مدة الاحتفاظ بنتائج Wan 3.0؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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