Passer au contenu

API Mage · Modèle vidéo

API Wan 3.0

Wan 3.0, avec un filtre strict

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

En un coup d’œil

L'API Wan 3.0 fait tourner Wan 3.0 via Mage à l'adresse POST https://api.mage.space/v1/wan_3/generate. Une requête avec les réglages par défaut coûte 245 Gems (environ 0,245 $), sans abonnement. Wan 3.0 accepte les personnages enregistrés, les références et les références audio via @handle dans le prompt.

  • VidéoSortie
  • 1Variante
  • 245Gems par clip, par défaut
  • $0.245Environ, en USD

Présentation

Ce que fait l'API Wan 3.0

Le Wan 3.0 tout-en-un d'Alibaba. Images de début et de fin, jusqu'à 10 références ou Characters, Voices et audio, et clips de 2 à 30 secondes jusqu'en 1080p. Filtre strict : le filtre de contenu du fournisseur s'applique.

Wan 3.0 d'Alibaba, un seul modèle vidéo pour le texte, les images clés, les images de référence, les vidéos de référence et les Voices, avec des clips de 2 à 30 secondes et audio généré. Filtre strict : le filtre de contenu du fournisseur analyse le prompt, les médias en entrée et la vidéo finale ; une requête qu'il refuse échoue avec `content_blocked` et un motif, et elle est remboursée.

Elle accepte first_image, last_image, image, additional_images, videos en entrée.

Démarrage rapide

Appeler l'API Wan 3.0

Définis MAGE_API_KEY, envoie ta requête à /wan_3/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.

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"])

Modèles

Valeurs model_id de Wan 3.0

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

model_idNomPar défaut
wan-3.0Wan 3.0Oui

Options

Paramètres de Wan 3.0

Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.

ChampValeurs
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

Entrées

Médias acceptés par Wan 3.0

Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.

ChampRôle
first_imageL'image de la première frame.
last_imageL'image de la dernière frame.
imageL'image de référence.
additional_imagesImages de référence supplémentaires.
videosLes vidéos sources.

Règles

Ce que l'API Wan 3.0 impose

  • Les première et dernière images ne peuvent pas être combinées avec des images ou vidéos de référence : envoie l'un ou l'autre.
  • Jusqu'à 10 images de référence et 5 vidéos de référence.
  • Chaque vidéo de référence dure de 1 à 15 secondes, 15 secondes maximum au total, et la durée totale plus `duration` ne dépasse pas 30 secondes. Les secondes de vidéo de référence sont facturées comme les secondes de sortie.

Plus de modèles vidéo

Autres API de génération vidéo sur Mage

  • Vidéo · à partir de 40 Gems

    API Wan Video v2.2

    Vidéo open-weights avec une variante Lightning

  • Vidéo · à partir de 189 Gems

    API Berry

    Une vidéo fidèle à tes références

  • Vidéo · à partir de 360 Gems

    API Blueberry

    Fixe la première et la dernière frame

  • Vidéo · à partir de 618 Gems

    API Cherry

    Notre famille de vidéos phare

  • Vidéo · à partir de 375 Gems

    API Grok Video

    Grok Imagine, en mouvement

  • Vidéo · à partir de 270 Gems

    API Kiwi

    La vidéo au quotidien, zéro configuration

FAQ

Questions fréquentes

Combien coûte l'API Wan 3.0 ?
Une requête Wan 3.0 avec les réglages par défaut (Wan 3.0) coûte 245 Gems, soit environ 0,245 $. Les autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; celle que bloque la politique de contenu de Mage ne l'est pas.
Quel est le point de terminaison de l'API Wan 3.0 ?
POST https://api.mage.space/v1/wan_3/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles Wan 3.0 puis-je appeler ?
wan-3.0 (Wan 3.0). Le modèle par défaut est Wan 3.0.
Wan 3.0 prend-il en charge les images de référence ou les personnages ?
Wan 3.0 accepte first_image, last_image, image, additional_images et videos. Wan 3.0 accepte les personnages enregistrés, les références et les références audio via @handle dans le prompt.
Puis-je utiliser Wan 3.0 depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Wan 3.0 par son nom. Ton assistant lit ses options avec get_model et t'indique le prix avant de lancer la génération.
Combien de temps les résultats de Wan 3.0 sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

Lance-toi avec Mage

Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.