Berry API

Auf 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.

• Video

  Ausgabe

• 2

  Varianten

• 189

  Gems pro Clip, Standard

• $0.189

  Ca. 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.

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"

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

# 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.

Optionen

Berry-Parameter

Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.

Eingaben

Medieneingaben, die Berry akzeptiert

Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.

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

FAQ

Häufig gestellte Fragen

Starte jetzt mit Mage

Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.

Ähnliche Inhalte

• API für KI-Videogenerierung
• Berry-API-Referenz
• Berry Playground
• Alle API-Modelle
• Mage MCP-Server