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.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 میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| first_image | تصویر فریم اول. |
| last_image | تصویر فریم آخر. |
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
| videos | ویدیوهای مبدأ. |
قوانین
محدودیتهایی که API مدل Wan 3.0 اعمال میکند
- فریم اول و آخر را نمیتوان همراه با تصاویر یا ویدیوهای مرجع ارسال کرد: فقط یکی از این دو نوع را بفرستید.
- حداکثر ۱۰ تصویر مرجع و ۵ ویدیوی مرجع.
- هر ویدیوی مرجع باید بین ۱ تا ۱۵ ثانیه باشد، مجموع طول همهٔ آنها حداکثر ۱۵ ثانیه است و مجموع این طول بهعلاوهٔ `duration` نباید از ۳۰ ثانیه بیشتر شود. ثانیههای ویدیوی مرجع مثل ثانیههای خروجی محاسبه میشوند.
مدلهای ویدیویی بیشتر
سایر APIهای ساخت ویدیو در Mage
Wan Video v2.2 API
ویدیوی وزنباز با نسخهٔ Lightning
Berry API
ویدیویی که به مرجعهای شما وفادار میماند
Blueberry API
تعیین فریم اول و آخر
Cherry API
خانوادهی پرچمدار ما برای ویدیو
Grok Video API
Grok Imagine در حرکت
Kiwi API
ویدیوی روزمره، بدون هیچ راهاندازی
سؤالات متداول
سؤالات متداول
API مدل Wan 3.0 چقدر هزینه دارد؟
نقطه پایانی API مدل Wan 3.0 چیست؟
کدام مدلهای Wan 3.0 را میتوانم فراخوانی کنم؟
آیا Wan 3.0 از تصاویر مرجع یا شخصیتها پشتیبانی میکند؟
آیا میتوانم از Wan 3.0 در Claude یا ChatGPT استفاده کنم؟
نتایج Wan 3.0 تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.