Mage API · مدل ویدیو
API مدل Berry
ویدیویی که به تصاویر مرجع شما وفادار میماند
POST https://api.mage.space/v1/berry/generateدر یک نگاه
API مدل Berry، مدل Berry 2 و ۱ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/berry/generate اجرا میکند. هزینه یک درخواست با تنظیمات پیشفرض ۱۸۹ Gems (حدود $0.189) است، بدون اشتراک. Berry کاراکترها و مرجعهای ذخیرهشده را با @handle در پرامپت میپذیرد.
- ویدیوخروجی
- 2نسخهها
- 189Gems برای هر کلیپ، پیشفرض
- $0.189حدود، به دلار
نگاه کلی
API مدل Berry چه کاری انجام میدهد
ویدیویی که به تکتک تصاویر مرجع شما وفادار میماند. یک فریم شروع، تا 9 تصویر مرجع یا Characters، یا یک ویدیوی منبع برای ویرایش؛ از 3 تا 15 ثانیه، با کیفیت تا 1080p.
مدل ویدیوی مرجعمحور Mage که به تصاویر شما وفادار میماند؛ Berry 2 نسخه فعلی است. یک فریم اول یا چند تصویر مرجع، یا یک ویدیوی منبع برای ویرایش.
ورودیهای first_image، image، additional_images و video را میپذیرد.
شروع سریع
فراخوانی API مدل Berry
MAGE_API_KEY را تنظیم کنید، درخواست را به /berry/generate بفرستید و تا تکمیل درخواست، status_url را مرتب بررسی کنید.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])مدلها
مقادیر model_id در Berry
برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیشفرض را اجرا میکند.
| model_id | نام | پیشفرض |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | بله |
گزینهها
پارامترهای Berry
مقادیر مجاز برای همه نسخهها؛ ممکن است یک نسخه گزینههای کمتری داشته باشد. گزینههای هر نسخه در مستندات آمده است.
| فیلد | مقادیر |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
ورودیها
ورودیهای رسانهای که Berry میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| first_image | تصویر فریم اول. |
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
| video | ویدیوی مبدأ. |
قوانین
قوانینی که Berry API اعمال میکند
- فریم اول را نمیتوان همراه با تصاویر مرجع استفاده کرد.
- ویرایش ویدیو فقط روی `berry` کار میکند، نه `berry-2`: مقدار `model_id: "berry"` را همراه با یک ویدیوی مبدأ بین 3 تا 60 ثانیه ارسال کنید.
مدلهای ویدیویی بیشتر
سایر APIهای ساخت ویدیو در Mage
Blueberry API
تعیین فریم اول و آخر
Cherry API
خانوادهی پرچمدار ما برای ویدیو
Grok Video API
Grok Imagine در حرکت
Kiwi API
ویدیوی روزمره، بدون هیچ راهاندازی
Lemon API
همهی قابلیتهای ویدیو با قیمتی مناسبتر
LTX Video API
ویدیوی سریع با وزنهای باز برای آزمون و خطا
سؤالات متداول
سؤالات متداول
هزینه Berry API چقدر است؟
اندپوینت Berry API چیست؟
کدام مدلهای Berry را میتوان فراخوانی کرد؟
آیا Berry از تصاویر مرجع یا کاراکترها پشتیبانی میکند؟
آیا میتوانم Berry را از Claude یا ChatGPT استفاده کنم؟
نتایج Berry تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.