In breve
L'API di Blueberry esegue Blueberry e un'altra variante tramite Mage su POST https://api.mage.space/v1/blueberry/generate. Una richiesta con le impostazioni predefinite costa 360 Gems (circa 0,36 $), senza abbonamento. Blueberry usa i riferimenti audio salvati tramite @handle nel prompt.
Video
Output
2
Varianti
360
Gems per clip, predefinito
$0.36
Circa, in USD
Panoramica
Cosa fa l'API di Blueberry
Imposta il primo e l'ultimo fotogramma e guarda come viene generato il movimento in mezzo, con audio. Da 2 a 15 secondi a 720p o 1080p.
Un modello video che genera il movimento tra un primo e un ultimo fotogramma, con audio; Blueberry 2 è la versione attuale.
Accetta first_image, last_image come input.
Guida rapida
Richiama l'API di Blueberry
Imposta MAGE_API_KEY, invia la richiesta a /blueberry/generate e interroga status_url finché la richiesta non è completata.
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"])Modelli
Valori model_id di Blueberry
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| blueberry | Blueberry | |
| blueberry-v2 | Blueberry | Sì |
Opzioni
Parametri di Blueberry
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| 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 |
Input
Input multimediali accettati da Blueberry
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| first_image | L'immagine del primo frame. |
| last_image | L'immagine dell'ultimo fotogramma. |
Regole
Cosa applica l'API di Blueberry
- L'ultimo fotogramma è supportato solo su `blueberry-v2`.
Altri modelli video
Altre API per generare video su Mage
Video · da 618 Gems
API Cherry
La nostra famiglia di modelli video di punta
Video · da 375 Gems
API di Grok Video
Grok Imagine, in movimento
Video · da 270 Gems
API di Kiwi
Video di tutti i giorni, senza configurazione
Video · da 245 Gems
API Lemon
Tutte le funzioni video, a un prezzo più accessibile
Video · da 20 Gems
API di LTX Video
Video veloce open-weights per iterare
Video · da 147 Gems
API di Melon
Anime in movimento, con audio opzionale
FAQ
Domande frequenti
Quanto costa l'API di Blueberry?
Una richiesta Blueberry con le impostazioni predefinite (Blueberry) costa 360 Gems, circa 0,36 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica il costo esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla policy sui contenuti di Mage no.
Qual è l'endpoint dell'API di Blueberry?
POST https://api.mage.space/v1/blueberry/generate con un header Authorization: Bearer contenente la tua chiave API di Mage. La risposta include uno status_url da interrogare per ottenere il risultato.
Quali modelli Blueberry posso richiamare?
blueberry, blueberry-v2. Il modello predefinito è Blueberry.
Blueberry supporta immagini di riferimento o personaggi?
Blueberry accetta first_image, last_image. Blueberry usa i riferimenti audio salvati tramite @handle nel prompt.
Posso usare Blueberry da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Blueberry per nome. Il tuo assistente legge le sue opzioni con get_model e ti indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Blueberry?
Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.