API di Mage · Generazione video
L'API per generare video con l'IA, da testo o immagini
Da testo a video, da immagine a video, da primo e ultimo fotogramma e da riferimenti a video con 15 modelli, guidati da Cherry 2 Pro, il modello di punta di Mage, con audio su molte clip.
POST https://api.mage.space/v1/{model}/generateIn breve
L'API di generazione video di Mage è un'API REST su https://api.mage.space/v1 che esegue 15 modelli da testo a video e da immagine a video, tra cui Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video e Wan. Invii un prompt e, se vuoi, fotogrammi o riferimenti, controlli lo stato della richiesta e scarichi un MP4. Ogni clip si paga in Gems in base a modello, risoluzione e durata.
- 15modelli video
- $0.02Opzione predefinita più economica, per clip
- 20Generazioni simultanee
- $0Costo mensile
Modelli
Tutti i modelli video dell'API di Mage
I prezzi sono per generazione, in Gems. 1.000 Gems costano 1 $ con il pacchetto standard, e i pacchetti più grandi aggiungono Gems bonus. Il prezzo dipende da modello, risoluzione e durata; qui è mostrato il prezzo con le impostazioni predefinite, e ogni risposta indica l'addebito esatto in billing.gems_charged. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.
| Modello | Ideale per | Valori di model_id | Prezzo predefinito |
|---|---|---|---|
| Berry | Video fedeli ai tuoi riferimenti | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fissa il primo e l'ultimo fotogramma | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | La nostra famiglia di video di punta | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, in movimento | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video di tutti i giorni, senza configurazione | kiwi | 270 Gems ($0.27) |
| Lemon | Tutte le funzioni video, a un prezzo più amichevole | lemon | 245 Gems ($0.245) |
| LTX Video | Video open-weights veloce per iterare | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Rifai qualsiasi video mantenendone il movimento | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Anime in movimento, con audio opzionale | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Video open veloce con audio stereo | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Audio su ogni clip, fino a 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Personaggi che prendono vita da un primo fotogramma | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, con filtro rigoroso | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, con filtro rigoroso | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Video open-weights con una variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Guida rapida
Genera un video con Berry 2
Imposta MAGE_API_KEY, invia la richiesta e controlla lo stato finché non è completata. Sostituisci berry nell'URL con uno qualsiasi dei modelli qui sopra.
cURL
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"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('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);Python
# 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"])Come funziona
Dalla chiave API al media finito in tre chiamate
Tutti i modelli condividono un unico schema di autenticazione, un unico ciclo di vita asincrono delle richieste e gli stessi nomi dei campi.
Crea una chiave API
Accedi a Mage, apri API → API Keys e crea una chiave. Inizia con mage_sk_ e viene mostrata una sola volta. Un account può avere 10 chiavi attive.
Invia una generazione
Invia con POST un corpo JSON a https://api.mage.space/v1/{model}/generate con un header Authorization: Bearer. La risposta arriva subito con un request_id, uno status e uno status_url. Aggiungi un header Idempotency-Key così un nuovo tentativo non ti farà mai pagare due volte.
Controlla lo stato e scarica
Interroga status_url finché lo stato non è completed, failed o cancelled. Una richiesta completata contiene result.url con il file di immagine, video o audio, conservato per 30 giorni.
Pensata per la produzione
Cosa ottiene ogni richiesta all'API di Mage
Una chiave, tutti i modelli
37 modelli per immagini, video e audio dietro una sola API REST e un solo saldo di Gems. Cambi modello modificando il percorso dell'URL.
Paghi per generazione
Nessun abbonamento e nessuna spesa minima. Acquisti Gems e ogni richiesta costa il prezzo indicato. Se una generazione fallisce, ti viene rimborsata, a meno che non sia stata bloccata dalla content policy di Mage.
Nuovi tentativi sicuri
Con le chiavi di idempotenza, un nuovo invio restituisce la richiesta originale senza addebitarti di nuovo.
Personaggi coerenti
Salva un personaggio o un riferimento una volta sola, poi scrivi @handle in qualsiasi prompt per usarlo con tutti i modelli che lo supportano.
File di grandi dimensioni
Invia input di immagini, video e audio come URL o data URL, oppure carica file fino a 100 MB con un upload firmato.
20 generazioni in parallelo
Ogni account può eseguire 20 generazioni contemporaneamente e il limite può essere aumentato in base alle tue esigenze. Le richieste rifiutate non vengono mai addebitate.
Casi d'uso
Cosa creano gli sviluppatori con l'API video
Video brevi e social
Crea clip verticali per TikTok, Reels e Shorts a partire da un prompt o dall'immagine di un prodotto.
Anima le immagini statiche
Trasforma un primo fotogramma, o un primo e un ultimo fotogramma, in movimento con modelli da immagine a video come Lemon e Kiwi.
Storie guidate dai personaggi
Mantieni lo stesso personaggio in tutte le inquadrature con modelli da riferimento a video che accettano personaggi @handle.
Video con audio
Plum e altri modelli generano voci, effetti sonori e atmosfera insieme alle immagini e accettano riferimenti audio per le voci.
Pubblicità e demo di prodotto
Genera molte varianti di uno spot e scegli la migliore, con invii idempotenti che non addebitano mai due volte.
Modifica clip esistenti
Berry, Plum e Grok Video modificano un video di partenza che invii; Lemon e MiniMax-H3 accettano anche video di riferimento.
FAQ
Domande frequenti
Qual è la migliore API per generare video con l'IA?
L'API video supporta da immagine a video?
Quanto possono durare i video generati?
Quanto ci vuole a generare un video?
Quanto costa l'API di Mage?
Mi serve un abbonamento a Mage per usare l'API?
Posso usare a fini commerciali i contenuti generati con l'API?
Quali sono i limiti di richieste?
Il mio agente AI può usare l'API di Mage?
Esiste un SDK per l'API di Mage?
Uso già un'altra API di generazione. Cosa devo cambiare?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.