Cherry API

لمحة سريعة

تشغّل Cherry API النموذج Cherry 2 Pro و3 نماذج أخرى عبر Mage على POST https://api.mage.space/v1/cherry/generate. يكلّف الطلب بالإعدادات الافتراضية 618 Gems (حوالي 0.618$) بدون أي اشتراك. يقبل Cherry الشخصيات والمراجع والمراجع الصوتية المحفوظة عبر @handle في الوصف.

• فيديو

  المخرجات

• 4

  الإصدارات

• 618

  Gems لكل مقطع، افتراضيًا

• $0.618

  التكلفة التقريبية بالدولار

نظرة عامة

ماذا تقدّم Cherry API

فيديو سينمائي بصوت، من Cherry Mini للمسودات إلى Cherry 2 Pro، أقوى نماذجنا، بمقاطع تصل إلى 30 ثانية ومراجع أو Characters متعددة وتعديلات على فيديو مصدر.

سلسلة الفيديو الرائدة من Mage بحركة سينمائية وصوت: Cherry Mini وCherry وCherry Pro وCherry 2 Pro الأقوى، بمقاطع تصل إلى 30 ثانية.

تقبل المدخلات image وadditional_images وvideos.

بداية سريعة

استدعاء Cherry API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /cherry/generate، ثم استعلم عن status_url إلى أن يكتمل الطلب.

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"

// 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);

# 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 لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

الخيارات

معلمات Cherry

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

المدخلات

مدخلات الوسائط التي يقبلها Cherry

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

القواعد

القيود التي تفرضها Cherry API

• يتطلب تعديل الفيديو فيديو مصدر واحدًا بالضبط، مدته من 4 إلى 30 ثانية في `cherry-2-pro` ومن 2 إلى 15 ثانية في النماذج الأخرى.
• في `cherry-2-pro`، يحتفظ التعديل بمدة الفيديو المصدر ونسبة أبعاده: يتم تجاهل `duration` و`aspect_ratio`، ويتبع السعر مدة الفيديو.

المزيد من نماذج الفيديو

واجهات برمجة أخرى لتوليد الفيديو على Mage

الأسئلة الشائعة

الأسئلة الشائعة

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

ذات صلة

• واجهة API لتوليد الفيديو بالذكاء الاصطناعي
• مرجع واجهة Cherry API
• ساحة تجربة Cherry
• جميع نماذج API
• خادم Mage MCP