Vai al contenuto

API di Mage · Modello video

Raspberry API

Personaggi che prendono vita da un primo frame

POST https://api.mage.space/v1/raspberry/generate

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.

  • VideoOutput
  • 1Variante
  • 360Gems per clip, predefinito
  • $0.36Circa, 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_idNomePredefinito
raspberryRaspberrySì

Opzioni

Parametri di Raspberry

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

CampoValori
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution720p, 1080p
duration2, 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.

CampoRuolo
first_imageL'immagine del primo frame.
imageL'immagine di riferimento.
additional_imagesImmagini di riferimento aggiuntive.

Altri modelli video

Altre API per generare video su Mage

  • Video · da 618 Gems

    API Seedance

    Seedance, con un filtro rigoroso

  • Video · da 245 Gems

    API Wan 3.0

    Wan 3.0, con un filtro rigoroso

  • 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

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.

CharactersCommunity