Mage API · مدل ویدیو
API مدل Seedance
Seedance، با فیلتر سختگیرانه
POST https://api.mage.space/v1/seedance/generateدر یک نگاه
API مدل Seedance، مدل Seedance 2.5 و ۳ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/seedance/generate اجرا میکند. یک درخواست با تنظیمات پیشفرض 618 Gems (حدود 0.618 دلار) هزینه دارد و اشتراکی لازم نیست. Seedance شخصیتها، مرجعها و مرجعهای صوتی ذخیرهشده را با @handle در پرامپت میپذیرد.
- ویدیوخروجی
- 4نسخهها
- 618Gems برای هر کلیپ، پیشفرض
- $0.618حدود، به دلار
نگاه کلی
API مدل Seedance چه کار میکند
Seedance از ByteDance، از Seedance 2.0 Mini برای پیشنویس تا Seedance 2.5، با کلیپهایی تا ۳۰ ثانیه، مرجعها یا Characters متعدد و ویرایش ویدیوی منبع. فیلتر سختگیرانه: فیلتر محتوای ارائهدهنده اعمال میشود.
خانواده مدلهای ویدیویی Seedance از ByteDance با حرکت سینمایی و صدا: Seedance 2.0 Mini، Seedance 2.0 Fast، Seedance 2.0 و Seedance 2.5 که قدرتمندترین آنهاست و کلیپهایی تا ۳۰ ثانیه میسازد. فیلتر سختگیرانه: فیلتر محتوای ارائهدهنده، پرامپت، رسانههای ورودی و ویدیوی نهایی را بررسی میکند. درخواستی که رد شود با `content_blocked` و یک دلیل ناموفق میشود و هزینهاش برگردانده میشود.
ورودیهای image، additional_images و videos را میپذیرد.
شروع سریع
فراخوانی API مدل 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 میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
| videos | ویدیوهای مبدأ. |
قوانین
محدودیتهایی که API مدل Seedance اعمال میکند
- ویرایش ویدیو دقیقاً یک ویدیوی منبع میگیرد، به طول ۴ تا ۳۰ ثانیه در `seedance-2.5` و ۲ تا ۱۵ ثانیه در مدلهای دیگر.
- در `seedance-2.5` ویرایش، طول و نسبت تصویر ویدیوی منبع را حفظ میکند: `duration` و `aspect_ratio` نادیده گرفته میشوند و قیمت بر اساس طول ویدیو تعیین میشود.
مدلهای ویدیویی بیشتر
سایر APIهای ساخت ویدیو در Mage
API مدل Wan 3.0
Wan 3.0، با فیلتر سختگیرانه
Wan Video v2.2 API
ویدیوی وزنباز با نسخهٔ Lightning
Berry API
ویدیویی که به مرجعهای شما وفادار میماند
Blueberry API
تعیین فریم اول و آخر
Cherry API
خانوادهی پرچمدار ما برای ویدیو
Grok Video API
Grok Imagine در حرکت
سؤالات متداول
سؤالات متداول
API مدل Seedance چقدر هزینه دارد؟
نشانی endpoint مدل Seedance چیست؟
کدام مدلهای Seedance را میتوانم فراخوانی کنم؟
آیا Seedance از تصویر مرجع یا شخصیت پشتیبانی میکند؟
آیا میتوانم Seedance را از داخل Claude یا ChatGPT استفاده کنم؟
نتایج Seedance تا چه مدت نگه داشته میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.