Mage API · مدل ویدیو
Cherry API
خانواده مدلهای ویدیوی شاخص ما
POST https://api.mage.space/v1/cherry/generateدر یک نگاه
Cherry API مدل Cherry 2 Pro و ۳ نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/cherry/generate اجرا میکند. هزینه یک درخواست با تنظیمات پیشفرض ۶۱۸ Gem (حدود ۰٫۶۱۸ دلار) است، بدون اشتراک. Cherry کاراکترها و مرجعها و مرجعهای صوتی ذخیرهشده را با @handle در پرامپت میگیرد.
- ویدیوخروجی
- 4نسخهها
- 618Gems برای هر کلیپ، پیشفرض
- $0.618حدود، به دلار
نگاه کلی
Cherry API چه کاری انجام میدهد
ویدیوی سینمایی همراه با صدا؛ از Cherry Mini برای پیشنویس تا Cherry 2 Pro، قدرتمندترین مدل ما، با کلیپهایی تا ۳۰ ثانیه، مرجعها یا Characters متعدد و ویرایش ویدیوی مبدأ.
مجموعه ویدیوی شاخص Mage با حرکت سینمایی و صدا: Cherry Mini، Cherry، Cherry Pro و Cherry 2 Pro که قدرتمندترین است و کلیپهایی تا ۳۰ ثانیه میسازد.
ورودیهای image، additional_images و videos را میپذیرد.
شروع سریع
فراخوانی Cherry API
MAGE_API_KEY را تنظیم کنید، درخواست را به /cherry/generate بفرستید و تا تکمیل درخواست، status_url را پیوسته بررسی کنید.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])مدلها
مقادیر model_id در Cherry
برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیشفرض را اجرا میکند.
| model_id | نام | پیشفرض |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2-pro | Cherry 2 Pro | بله |
گزینهها
پارامترهای Cherry
مقادیر مجاز برای همه نسخهها؛ ممکن است یک نسخه گزینههای کمتری داشته باشد. گزینههای هر نسخه در مستندات آمده است.
| فیلد | مقادیر |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
ورودیها
ورودیهای رسانهای که Cherry میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
| videos | ویدیوهای مبدأ. |
قوانین
محدودیتهایی که Cherry API اعمال میکند
- ویرایش ویدیو دقیقاً یک ویدیوی مبدأ میگیرد، به طول ۴ تا ۳۰ ثانیه در `cherry-2-pro` و ۲ تا ۱۵ ثانیه در بقیه مدلها.
- در `cherry-2-pro` ویرایش، طول و نسبت تصویر ویدیوی مبدأ را حفظ میکند: `duration` و `aspect_ratio` نادیده گرفته میشوند و قیمت بر اساس طول ویدیو محاسبه میشود.
مدلهای ویدیویی بیشتر
سایر APIهای ساخت ویدیو در Mage
Grok Video API
Grok Imagine در حرکت
Kiwi API
ویدیوی روزمره، بدون هیچ راهاندازی
Lemon API
همهی قابلیتهای ویدیو با قیمتی مناسبتر
LTX Video API
ویدیوی سریع با وزنهای باز برای آزمون و خطا
Melon API
انیمه در حرکت، با صدای اختیاری
MiniMax-H3 API
ویدیوی متنباز سریع با صدای استریو
سؤالات متداول
سؤالات متداول
هزینه Cherry API چقدر است؟
آدرس endpoint در Cherry API چیست؟
کدام مدلهای Cherry را میتوانم فراخوانی کنم؟
آیا Cherry از تصاویر مرجع یا کاراکترها پشتیبانی میکند؟
آیا میتوانم Cherry را از داخل Claude یا ChatGPT استفاده کنم؟
نتیجههای Cherry تا چه مدت نگه داشته میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.