Bir bakışta
Cherry API, Cherry 2 Pro ve diğer 3 varyantı Mage üzerinden POST https://api.mage.space/v1/cherry/generate adresinde çalıştırır. Varsayılan ayarlarla bir istek 618 Gems (yaklaşık $0.618) tutar, abonelik gerekmez. Cherry, kayıtlı karakterleri, referansları ve ses referanslarını prompt içinde @handle ile alır.
Video
Çıktı
4
Varyantlar
618
Klip başına Gems, varsayılan
$0.618
Yaklaşık, USD
Genel bakış
Cherry API ne yapar?
Sesli sinematik video: taslaklar için Cherry Mini'den en güçlü modelimiz Cherry 2 Pro'ya kadar. 30 saniyeye varan klipler, çok sayıda referans veya Characters ve kaynak video düzenlemeleri sunar.
Mage'in sinematik hareket ve ses sunan amiral gemisi video serisi: Cherry Mini, Cherry, Cherry Pro ve en güçlüsü Cherry 2 Pro, 30 saniyeye kadar kliplerle.
Girdi olarak image, additional_images ve videos kabul eder.
Hızlı başlangıç
Cherry API'yi çağırma
MAGE_API_KEY'i ayarla, isteği /cherry/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.
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"])Modeller
Cherry model_id değerleri
Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.
| model_id | Ad | Varsayılan |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2-pro | Cherry 2 Pro | Evet |
Seçenekler
Cherry parametreleri
Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.
| Alan | Değerler |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Girdiler
Cherry'nin kabul ettiği medya girdileri
Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.
| Alan | Rol |
|---|---|
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
| videos | Kaynak videolar. |
Kurallar
Cherry API'nin uyguladığı kurallar
- Video düzenleme için tam olarak bir kaynak video gerekir: `cherry-2-pro` için 4 ila 30 saniye, diğer modeller için 2 ila 15 saniye.
- `cherry-2-pro` üzerinde bir düzenleme, kaynak videonun süresini ve en boy oranını korur: `duration` ve `aspect_ratio` yok sayılır, fiyat ise videonun süresine göre belirlenir.
Diğer video modelleri
Mage'deki diğer yapay zeka video oluşturma API'leri
Video · 375 Gems'ten başlayan fiyatlarla
Grok Video API
Grok Imagine, hareket halinde
Video · 270 Gems'ten başlayan fiyatlarla
Kiwi API
Günlük videolar, sıfır kurulum
Video · 245 Gem'den başlayan fiyatlarla
Lemon API
Tüm video özellikleri, daha uygun fiyata
Video · 20 Gems'ten başlayan fiyatlarla
LTX Video API
Hızlı denemeler için açık ağırlıklı video modeli
Video · 147 Gems'ten başlayan fiyatlarla
Melon API
Hareket halinde anime, isteğe bağlı sesle
Video · 30 Gems'ten başlayan fiyatlarla
MiniMax-H3 API
Stereo sesli hızlı açık video modeli
SSS
Sık sorulan sorular
Cherry API'nin maliyeti nedir?
Varsayılan ayarlarla (Cherry 2 Pro) bir Cherry isteği 618 Gems, yani yaklaşık $0.618 tutar. Farklı çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta belirtilir. Başarısız olan üretimlerin ücreti iade edilir; Mage'in içerik politikası nedeniyle engellenenlerin iadesi yapılmaz.
Cherry API endpoint'i nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/cherry/generate. Yanıt, sonucu sorgulamak için bir status_url içerir.
Hangi Cherry modellerini çağırabilirim?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2-pro (Cherry 2 Pro). Varsayılan model Cherry 2 Pro'dur.
Cherry referans görsellerini veya karakterleri destekliyor mu?
Cherry; image, additional_images ve videos girdilerini kabul eder. Kayıtlı karakterleri, referansları ve ses referanslarını prompt içinde @handle ile alır.
Cherry'yi Claude veya ChatGPT üzerinden kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Cherry'yi adıyla iste. Asistanın seçeneklerini get_model ile okur ve üretmeden önce fiyatı söyler.
Cherry sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.