Auf einen Blick
Die Cherry API führt Cherry 2 Pro und 3 weitere Varianten über Mage aus, und zwar per POST https://api.mage.space/v1/cherry/generate. Eine Anfrage mit den Standardeinstellungen kostet 618 Gems (etwa 0,618 $), ohne Abo. Gespeicherte Characters, References und Audio-Referenzen übernimmt Cherry per @handle im Prompt.
Video
Ausgabe
4
Varianten
618
Gems pro Clip, Standard
$0.618
Ca. in USD
Überblick
Was die Cherry API kann
Filmische Videos mit Audio: von Cherry Mini für Entwürfe bis zu Cherry 2 Pro, unserem leistungsstärksten Modell, mit Clips von bis zu 30 Sekunden, vielen Referenzen oder Characters und Bearbeitungen von Quellvideos.
Die Flaggschiff-Videoreihe von Mage mit filmischer Bewegung und Audio: Cherry Mini, Cherry, Cherry Pro und Cherry 2 Pro, das leistungsstärkste Modell, mit Clips von bis zu 30 Sekunden.
Als Eingaben akzeptiert sie image, additional_images und videos.
Schnellstart
Die Cherry API aufrufen
Setze MAGE_API_KEY, sende die Anfrage an /cherry/generate und frage status_url so lange ab, bis die Anfrage abgeschlossen ist.
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"])Modelle
Cherry model_id-Werte
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2-pro | Cherry 2 Pro | Ja |
Optionen
Cherry-Parameter
Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.
| Feld | Werte |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Eingaben
Medieneingaben, die Cherry akzeptiert
Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.
| Feld | Rolle |
|---|---|
| image | Das Referenzbild. |
| additional_images | Weitere Referenzbilder. |
| videos | Die Quellvideos. |
Regeln
Was die Cherry API erzwingt
- Für die Videobearbeitung wird genau ein Quellvideo benötigt, mit 4 bis 30 Sekunden bei `cherry-2-pro` und 2 bis 15 Sekunden bei den anderen Modellen.
- Bei `cherry-2-pro` behält eine Bearbeitung die Länge und das Seitenverhältnis des Quellvideos bei: `duration` und `aspect_ratio` werden ignoriert, und der Preis richtet sich nach der Länge des Videos.
Weitere Videomodelle
Weitere APIs zur Videogenerierung auf Mage
Video · ab 375 Gems
Grok-Video-API
Grok Imagine in Bewegung
Video · ab 270 Gems
Kiwi-API
Alltagsvideos ohne Einrichtung
Video · ab 245 Gems
Lemon API
Alle Video-Funktionen zu einem fairen Preis
Video · ab 20 Gems
LTX-Video-API
Schnelles Open-Weights-Video zum Iterieren
Video · ab 147 Gems
Melon-API
Anime in Bewegung, optional mit Audio
Video · ab 30 Gems
MiniMax-H3 API
Schnelles offenes Video mit Stereoton
FAQ
Häufig gestellte Fragen
Was kostet die Cherry API?
Eine Cherry-Anfrage mit den Standardeinstellungen (Cherry 2 Pro) kostet 618 Gems, etwa 0,618 $. Andere Auflösungen, Dauern und Varianten ändern den Preis; die Antwort nennt die genauen Kosten. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte nicht.
Wie lautet der Endpunkt der Cherry API?
POST https://api.mage.space/v1/cherry/generate mit einem Authorization: Bearer-Header, der deinen Mage API-Schlüssel enthält. Die Antwort enthält eine status_url, die du für das Ergebnis abfragen kannst.
Welche Cherry-Modelle kann ich aufrufen?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2-pro (Cherry 2 Pro). Standard ist Cherry 2 Pro.
Unterstützt Cherry Referenzbilder oder Characters?
Cherry akzeptiert image, additional_images und videos. Gespeicherte Characters, References und Audio-Referenzen übernimmt Cherry per @handle im Prompt.
Kann ich Cherry über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frag direkt nach Cherry. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er etwas generiert.
Wie lange werden Cherry-Ergebnisse gespeichert?
Ergebnisse und Eingaben werden 30 Tage lang gespeichert. Lade alles, was du behalten möchtest, in deinen eigenen Speicher herunter.
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.