Mage API · Videomodell
Berry API
Video, das deinen Referenzen treu bleibt
POST https://api.mage.space/v1/berry/generateAuf einen Blick
Die Berry API führt Berry 2 und 1 weitere Variante über Mage aus, unter POST https://api.mage.space/v1/berry/generate. Eine Anfrage mit den Standardeinstellungen kostet 189 Gems (etwa 0,189 $), ohne Abo. Berry akzeptiert gespeicherte Characters und Referenzen per @handle im Prompt.
- VideoAusgabe
- 2Varianten
- 189Gems pro Clip, Standard
- $0.189Ca. in USD
Überblick
Was die Berry API kann
Video, das jeder Referenz treu bleibt, die du angibst. Ein Startbild, bis zu 9 Referenzen oder Characters oder ein Quellvideo zum Bearbeiten; 3 bis 15 Sekunden in bis zu 1080p.
Das referenzbasierte Videomodell von Mage, treu zu den Bildern, die du angibst; Berry 2 ist die aktuelle Version. Ein erstes Bild oder Referenzbilder oder ein Quellvideo zum Bearbeiten.
Es akzeptiert first_image, image, additional_images und video als Eingaben.
Schnellstart
Die Berry API aufrufen
Setze MAGE_API_KEY, sende die Anfrage an /berry/generate und frage status_url ab, bis sie abgeschlossen ist.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])Modelle
Berry model_id-Werte
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Ja |
Optionen
Berry-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, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Eingaben
Medieneingaben, die Berry akzeptiert
Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.
| Feld | Rolle |
|---|---|
| first_image | Das Bild des ersten Frames. |
| image | Das Referenzbild. |
| additional_images | Weitere Referenzbilder. |
| video | Das Quellvideo. |
Regeln
Was die Berry-API durchsetzt
- Ein Startframe kann nicht mit Referenzbildern kombiniert werden.
- Videobearbeitung läuft nur mit `berry`, nicht mit `berry-2`: Sende `model_id: "berry"` mit einem Quellvideo von 3 bis 60 Sekunden.
Weitere Videomodelle
Weitere APIs zur Videogenerierung auf Mage
Blueberry-API
Start- und Endframe festlegen
Cherry API
Unsere Flaggschiff-Videofamilie
Grok-Video-API
Grok Imagine in Bewegung
Kiwi-API
Alltagsvideos ohne Einrichtung
Lemon API
Alle Video-Funktionen zu einem fairen Preis
LTX-Video-API
Schnelles Open-Weights-Video zum Iterieren
FAQ
Häufig gestellte Fragen
Was kostet die Berry-API?
Wie lautet der Endpunkt der Berry-API?
Welche Berry-Modelle kann ich aufrufen?
Unterstützt Berry Referenzbilder oder Characters?
Kann ich Berry über Claude oder ChatGPT nutzen?
Wie lange werden Berry-Ergebnisse gespeichert?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.