Mage API · نموذج فيديو
Cherry API
عائلة نماذج الفيديو الرائدة لدينا
POST https://api.mage.space/v1/cherry/generateلمحة سريعة
تشغّل Cherry API النموذج Cherry 2 Pro و4 إصدارات أخرى عبر Mage على POST https://api.mage.space/v1/cherry/generate. يكلّف الطلب بالإعدادات الافتراضية 618 Gems (حوالي 0.618$)، بدون اشتراك. يقبل Cherry الشخصيات المحفوظة والمراجع والمراجع الصوتية عبر @handle في الوصف النصي.
- فيديوالمخرجات
- 5الإصدارات
- 618Gems لكل مقطع، افتراضيًا
- $0.618التكلفة التقريبية بالدولار
نظرة عامة
ماذا تقدّم Cherry API
فيديو سينمائي بصوت، من Cherry Mini للمسودات إلى Cherry 2 Pro، أقوى نماذجنا، بمقاطع تصل إلى 30 ثانية ومراجع أو Characters متعددة وتعديلات على فيديو مصدر.
سلسلة الفيديو الرائدة من Mage، بحركة سينمائية وصوت: Cherry Mini وCherry وCherry Pro وCherry 2 وCherry 2 Pro الأقوى بينها. تنتج نماذج Cherry 2 مقاطع تصل مدتها إلى 30 ثانية.
تقبل المدخلات 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 | Cherry 2 | |
| 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
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
| videos | مقاطع الفيديو المصدر. |
القواعد
القيود التي تفرضها Cherry API
- يتطلب تعديل الفيديو فيديو مصدر واحدًا فقط، مدته من 4 إلى 30 ثانية في `cherry-2` و`cherry-2-pro`، ومن 2 إلى 15 ثانية في النماذج الأخرى.
- في `cherry-2` و`cherry-2-pro` يحافظ التعديل على مدة الفيديو المصدر ونسبة أبعاده: يتم تجاهل `duration` و`aspect_ratio`، ويتبع السعر مدة الفيديو.
المزيد من نماذج الفيديو
واجهات برمجة أخرى لتوليد الفيديو على Mage
Grok Video API
Grok Imagine في حالة حركة
Kiwi API
فيديو للاستخدام اليومي دون أي إعداد
واجهة Lemon API
كل ميزات الفيديو بسعر أنسب
LTX Video API
فيديو سريع بأوزان مفتوحة للتجارب المتكررة
Magejutsu API
أعِد تمثيل أي فيديو مع الحفاظ على حركته
Melon API
أنمي متحرك، مع صوت اختياري
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Cherry API؟
ما هو عنوان نقطة نهاية Cherry API؟
ما نماذج Cherry التي يمكنني استدعاؤها؟
هل يدعم Cherry الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Cherry من Claude أو ChatGPT؟
كم مدة الاحتفاظ بنتائج Cherry؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.