L'API per generare video con l'IA, da testo o immagini

In breve

L'API di Mage per generare video è un'API REST su https://api.mage.space/v1 che esegue 12 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.

• 12

  modelli video

• $0.02

  Opzione predefinita più economica, per clip

• 20

  Generazioni simultanee

• $0

  Costo 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.

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.

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"

// 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);

# 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.

1. 01

   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.

2. 02

   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.

3. 03

   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

Casi d'uso

Cosa creano gli sviluppatori con l'API video

FAQ

Domande frequenti

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Correlati

• API per la generazione di immagini con AI
• API per la generazione di audio con AI
• Server MCP di Mage
• SDK di Mage
• Mage per ComfyUI
• Tutti i modelli API
• Playground API
• Documentazione API