Vai al contenuto

API di Mage · Modello video

API Wan 3.0

Wan 3.0, con filtro rigoroso

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

In breve

L'API Wan 3.0 esegue Wan 3.0 tramite Mage su POST https://api.mage.space/v1/wan_3/generate. Una richiesta con le impostazioni predefinite costa 245 Gems (circa 0,245 $), senza abbonamento. Wan 3.0 accetta nel prompt personaggi salvati, riferimenti e riferimenti audio tramite @handle.

  • VideoOutput
  • 1Variante
  • 245Gems per clip, predefinito
  • $0.245Circa, in USD

Panoramica

Cosa fa l'API Wan 3.0

Wan 3.0 di Alibaba, tutto in uno. Fotogramma iniziale e finale, fino a 10 riferimenti o Characters, Voices e audio, e clip da 2 a 30 secondi fino a 1080p. Filtro rigoroso: si applica il filtro dei contenuti del provider.

Wan 3.0 di Alibaba, un unico modello video per testo, frame, immagini di riferimento, video di riferimento e Voices, con clip da 2 a 30 secondi e audio generato. Filtro rigoroso: il filtro dei contenuti del provider controlla il prompt, i media in input e il video finito; una richiesta rifiutata dal filtro non va a buon fine, restituisce `content_blocked` con un motivo e viene rimborsata.

Accetta first_image, last_image, image, additional_images, videos come input.

Guida rapida

Chiama l'API Wan 3.0

Imposta MAGE_API_KEY, invia la richiesta a /wan_3/generate e controlla status_url finché la richiesta non è completata.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/wan_3/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": "wan-3.0"
}' | 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('wan_3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'wan-3.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("wan_3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "wan-3.0",
})

print(request["result"]["url"])

Modelli

Valori model_id di Wan 3.0

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

model_idNomePredefinito
wan-3.0Wan 3.0Sì

Opzioni

Parametri di Wan 3.0

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
resolution480p, 720p, 1080p
duration2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30

Input

Input multimediali accettati da Wan 3.0

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

CampoRuolo
first_imageL'immagine del primo frame.
last_imageL'immagine dell'ultimo fotogramma.
imageL'immagine di riferimento.
additional_imagesImmagini di riferimento aggiuntive.
videosI video di partenza.

Regole

Cosa applica l'API Wan 3.0

  • Primo e ultimo fotogramma non si possono combinare con immagini o video di riferimento: invia l'uno o l'altro.
  • Fino a 10 immagini di riferimento e 5 video di riferimento.
  • Ogni video di riferimento dura da 1 a 15 secondi, al massimo 15 secondi in totale, e la durata totale più `duration` non può superare i 30 secondi. I secondi dei video di riferimento si fatturano come i secondi di output.

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 l'API Wan 3.0?
Una richiesta Wan 3.0 con le impostazioni predefinite (Wan 3.0) costa 245 Gems, circa 0,245 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'addebito esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla policy sui contenuti di Mage no.
Qual è l'endpoint dell'API Wan 3.0?
POST https://api.mage.space/v1/wan_3/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 Wan 3.0 posso chiamare?
wan-3.0 (Wan 3.0). Il predefinito è Wan 3.0.
Wan 3.0 supporta immagini di riferimento o personaggi?
Wan 3.0 accetta first_image, last_image, image, additional_images, videos. Wan 3.0 accetta nel prompt personaggi salvati, riferimenti e riferimenti audio tramite @handle.
Posso usare Wan 3.0 da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Wan 3.0 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 Wan 3.0?
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.