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