Auf einen Blick
Die Blueberry-API führt Blueberry und 1 weitere Variante über Mage aus, unter POST https://api.mage.space/v1/blueberry/generate. Eine Anfrage mit den Standardeinstellungen kostet 360 Gems (etwa 0,36 $), ohne Abo. Blueberry nutzt gespeicherte Audio-Referenzen per @handle im Prompt.
Video
Ausgabe
2
Varianten
360
Gems pro Clip, Standard
$0.36
Ca. in USD
Überblick
Was die Blueberry-API kann
Lege Start- und Endframe fest und sieh zu, wie die Bewegung dazwischen entsteht, inklusive Audio. 2 bis 15 Sekunden in 720p oder 1080p.
Ein Videomodell, das die Bewegung zwischen einem Start- und einem Endframe ergänzt, mit Audio; Blueberry 2 ist die aktuelle Version.
Es akzeptiert first_image und last_image als Eingaben.
Schnellstart
Die Blueberry-API aufrufen
Setze MAGE_API_KEY, sende deine Anfrage an /blueberry/generate und frage status_url ab, bis die Anfrage abgeschlossen ist.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/blueberry/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": "blueberry-v2"
}' | 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('blueberry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'blueberry-v2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("blueberry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "blueberry-v2",
})
print(request["result"]["url"])Modelle
model_id-Werte für Blueberry
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| blueberry | Blueberry | |
| blueberry-v2 | Blueberry | Ja |
Optionen
Blueberry-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, 4:3, 1:1, 3:4, 9:16 |
| resolution | 720p, 1080p |
| duration | 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Eingaben
Medieneingaben, die Blueberry 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. |
| last_image | Das Bild für den Endframe. |
Regeln
Was die Blueberry-API durchsetzt
- Ein Endframe wird nur mit `blueberry-v2` unterstützt.
Weitere Videomodelle
Weitere APIs zur Videogenerierung auf Mage
Video · ab 618 Gems
Cherry API
Unsere Flaggschiff-Videofamilie
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
FAQ
Häufig gestellte Fragen
Was kostet die Blueberry-API?
Eine Blueberry-Anfrage mit den Standardeinstellungen (Blueberry) kostet 360 Gems, also etwa 0,36 $. Andere Auflösungen, Dauern und Varianten ändern den Preis; die Antwort nennt den genauen Betrag. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte nicht.
Wie lautet der Endpunkt der Blueberry-API?
POST https://api.mage.space/v1/blueberry/generate mit einem Authorization: Bearer-Header, der deinen Mage-API-Schlüssel enthält. Die Antwort enthält eine status_url, die du abfragen kannst, um das Ergebnis zu erhalten.
Welche Blueberry-Modelle kann ich aufrufen?
blueberry, blueberry-v2. Standard ist Blueberry.
Unterstützt Blueberry Referenzbilder oder Characters?
Blueberry akzeptiert first_image und last_image. Gespeicherte Audio-Referenzen übernimmt Blueberry per @handle im Prompt.
Kann ich Blueberry über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frag direkt nach Blueberry. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er etwas generiert.
Wie lange werden Blueberry-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.