In breve
La Raspberry API esegue Raspberry tramite Mage su POST https://api.mage.space/v1/raspberry/generate. Una richiesta con le impostazioni predefinite costa 360 Gems (circa 0,36 $), senza abbonamento. Raspberry usa personaggi salvati e riferimenti tramite @handle nel prompt.
Video
Output
1
Variante
360
Gems per clip, predefinito
$0.36
Circa, in USD
Panoramica
Cosa fa la Raspberry API
Video di personaggi a partire da un frame iniziale più fino a 5 riferimenti o Characters, con Voices e audio. Da 2 a 15 secondi a 720p o 1080p.
Un modello video per personaggi che parte da un primo frame e da immagini di riferimento, con Voices e audio.
Accetta come input first_image, image, additional_images.
Guida rapida
Chiama la Raspberry API
Imposta MAGE_API_KEY, invia la richiesta a /raspberry/generate e controlla status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/raspberry/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": "raspberry"
}' | 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('raspberry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'raspberry',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("raspberry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "raspberry",
})
print(request["result"]["url"])Modelli
Valori di model_id per Raspberry
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| raspberry | Raspberry | Sì |
Opzioni
Parametri di Raspberry
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 Raspberry
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| first_image | L'immagine del primo frame. |
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
Altri modelli video
Altre API per generare video su Mage
Video · da 40 Gems
API Wan Video v2.2
Video open-weights con variante Lightning
Video · da 189 Gems
API Berry
Video fedeli ai tuoi riferimenti
Video · da 360 Gems
API di Blueberry
Fissa il primo e l'ultimo fotogramma
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
FAQ
Domande frequenti
Quanto costa la Raspberry API?
Una richiesta Raspberry con le impostazioni predefinite (Raspberry) costa 360 Gems, circa 0,36 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta riporta l'addebito esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.
Qual è l'endpoint della Raspberry API?
POST https://api.mage.space/v1/raspberry/generate con un header Authorization: Bearer che contiene la tua chiave API di Mage. La risposta include uno status_url da controllare per ottenere il risultato.
Quali modelli Raspberry posso chiamare?
raspberry. Il modello predefinito è Raspberry.
Raspberry supporta immagini di riferimento o personaggi?
Raspberry accetta first_image, image, additional_images. Raspberry usa personaggi salvati e riferimenti tramite @handle nel prompt.
Posso usare Raspberry da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Raspberry per nome. Il tuo assistente legge le opzioni con get_model e ti indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Raspberry?
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.