رفتن به محتوا

Mage API · مدل ویدیو

API مدل Wan 3.0

Wan 3.0، با فیلتر سخت‌گیرانه

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

در یک نگاه

API مدل Wan 3.0 از طریق Mage و در POST https://api.mage.space/v1/wan_3/generate مدل Wan 3.0 را اجرا می‌کند. هزینه یک درخواست با تنظیمات پیش‌فرض 245 Gems (حدود $0.245) است، بدون اشتراک. Wan 3.0 شخصیت‌ها، مرجع‌ها و مرجع‌های صوتی ذخیره‌شده را با @handle در پرامپت می‌پذیرد.

  • ویدیوخروجی
  • 1نسخه
  • 245Gems برای هر کلیپ، پیش‌فرض
  • $0.245حدود، به دلار

نگاه کلی

API مدل Wan 3.0 چه کاری انجام می‌دهد

Wan 3.0 از Alibaba، یک مدل همه‌کاره. فریم شروع و پایان، تا 10 مرجع یا Characters، Voices و صدا، و کلیپ‌هایی از 2 تا 30 ثانیه با وضوح تا 1080p. فیلتر سخت‌گیرانه: فیلتر محتوای ارائه‌دهنده اعمال می‌شود.

Wan 3.0 از Alibaba، یک مدل ویدیویی برای متن، فریم‌ها، تصاویر مرجع، ویدیوهای مرجع و Voices، با کلیپ‌هایی از ۲ تا ۳۰ ثانیه و صدای تولیدشده. فیلتر سخت‌گیرانه: فیلتر محتوای ارائه‌دهنده، پرامپت، رسانه‌های ورودی و ویدیوی نهایی را بررسی می‌کند. درخواستی که رد شود با `content_blocked` و یک دلیل ناموفق می‌شود و هزینه‌اش برگردانده می‌شود.

ورودی‌های first_image، last_image، image، additional_images و videos را می‌پذیرد.

شروع سریع

فراخوانی API مدل Wan 3.0

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 می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
first_imageتصویر فریم اول.
last_imageتصویر فریم آخر.
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.
videosویدیوهای مبدأ.

قوانین

محدودیت‌هایی که API مدل Wan 3.0 اعمال می‌کند

  • فریم اول و آخر را نمی‌توان همراه با تصاویر یا ویدیوهای مرجع ارسال کرد: فقط یکی از این دو نوع را بفرستید.
  • حداکثر ۱۰ تصویر مرجع و ۵ ویدیوی مرجع.
  • هر ویدیوی مرجع باید بین ۱ تا ۱۵ ثانیه باشد، مجموع طول همهٔ آن‌ها حداکثر ۱۵ ثانیه است و مجموع این طول به‌علاوهٔ `duration` نباید از ۳۰ ثانیه بیشتر شود. ثانیه‌های ویدیوی مرجع مثل ثانیه‌های خروجی محاسبه می‌شوند.

مدل‌های ویدیویی بیشتر

سایر APIهای ساخت ویدیو در Mage

  • ویدیو · از ۴۰ Gem

    Wan Video v2.2 API

    ویدیوی وزن‌باز با نسخهٔ Lightning

  • ویدیو · از ۱۸۹ Gem

    Berry API

    ویدیویی که به مرجع‌های شما وفادار می‌ماند

  • ویدیو · از 360 Gems

    Blueberry API

    تعیین فریم اول و آخر

  • ویدیو · از ۶۱۸ Gem

    Cherry API

    خانواده‌ی پرچم‌دار ما برای ویدیو

  • ویدیو · از 375 Gems

    Grok Video API

    Grok Imagine در حرکت

  • ویدیو · از 270 Gems

    Kiwi API

    ویدیوی روزمره، بدون هیچ راه‌اندازی

سؤالات متداول

سؤالات متداول

API مدل Wan 3.0 چقدر هزینه دارد؟
یک درخواست Wan 3.0 با تنظیمات پیش‌فرض (Wan 3.0) 245 Gems هزینه دارد، حدود $0.245. وضوح، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ پاسخ، مبلغ دقیق را اعلام می‌کند. تولیدی که ناموفق باشد بازپرداخت می‌شود؛ اما تولیدی که سیاست محتوایی Mage مسدود کند بازپرداخت نمی‌شود.
نقطه پایانی API مدل Wan 3.0 چیست؟
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. Wan 3.0 شخصیت‌ها، مرجع‌ها و مرجع‌های صوتی ذخیره‌شده را با @handle در پرامپت می‌پذیرد.
آیا می‌توانم از Wan 3.0 در Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Wan 3.0 را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Wan 3.0 تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.