API Mage · Génération de vidéos
L'API de génération de vidéos par IA, à partir de texte ou d'images
Texte vers vidéo, image vers vidéo, première et dernière image, et références vers vidéo avec 15 modèles, dont le modèle phare de Mage, Cherry 2 Pro, avec audio sur de nombreux clips.
POST https://api.mage.space/v1/{model}/generateEn un coup d’œil
L'API de génération vidéo de Mage est une API REST sur https://api.mage.space/v1 qui fait tourner 15 modèles de texte vers vidéo et d'image vers vidéo, dont Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video et Wan. Envoyez un prompt, avec des images ou références en option, interrogez la requête, puis téléchargez un MP4. Chaque clip se paie en Gems selon le modèle, la résolution et la durée.
- 15modèles vidéo
- $0.02Option par défaut la moins chère, par clip
- 20Générations simultanées
- $0Frais mensuels
Modèles
Tous les modèles vidéo de l'API Mage
Les prix s'entendent par génération, en Gems. 1 000 Gems coûtent 1 $ avec le pack standard, et les packs plus grands ajoutent des Gems bonus. Le prix dépend du modèle, de la résolution et de la durée ; c'est le prix avec les réglages par défaut qui est affiché, et chaque réponse indique le montant exact débité dans billing.gems_charged. Une génération qui échoue est remboursée ; celle bloquée par la politique de contenu de Mage ne l'est pas.
| Modèle | Idéal pour | Valeurs de model_id | Prix par défaut |
|---|---|---|---|
| Berry | Une vidéo fidèle à tes références | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fixe la première et la dernière image | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Notre famille vidéo phare | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, en mouvement | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | La vidéo au quotidien, sans configuration | kiwi | 270 Gems ($0.27) |
| Lemon | Toutes les fonctions vidéo, à prix plus doux | lemon | 245 Gems ($0.245) |
| LTX Video | Vidéo open-weights rapide pour itérer | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Redonnez vie à n'importe quelle vidéo en gardant son mouvement | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | L'animation manga en mouvement, avec audio en option | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Vidéo ouverte rapide avec son stéréo | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Du son sur chaque clip, jusqu'en 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Des personnages animés à partir d'une première image | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, avec un filtre strict | 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, avec un filtre strict | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Vidéo open-weights avec une variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Démarrage rapide
Génère une vidéo avec Berry 2
Définis MAGE_API_KEY, envoie la requête, puis interroge-la jusqu'à ce qu'elle soit terminée. Remplace berry dans l'URL par n'importe quel modèle ci-dessus.
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"])Comment ça marche
De la clé d'API au média final en trois appels
Tous les modèles partagent le même schéma d'authentification, le même cycle de requête asynchrone et les mêmes noms de champs.
Crée une clé d'API
Connecte-toi à Mage, ouvre API → Clés d'API et crée une clé. Elle commence par mage_sk_ et ne s'affiche qu'une seule fois. Un compte peut avoir 10 clés actives.
Lance une génération
Envoie en POST un corps JSON à https://api.mage.space/v1/{model}/generate avec un en-tête Authorization: Bearer. La réponse arrive immédiatement avec un request_id, un status et un status_url. Ajoute un en-tête Idempotency-Key pour qu'une nouvelle tentative ne soit jamais facturée deux fois.
Interroge et télécharge
Interroge status_url jusqu'à ce que le statut soit completed, failed ou cancelled. Une requête terminée contient result.url, qui pointe vers le fichier image, vidéo ou audio, conservé 30 jours.
Conçue pour la production
Ce que reçoit chaque requête de l'API Mage
Une clé, tous les modèles
37 modèles d'image, de vidéo et d'audio derrière une seule API REST et un seul solde de Gems. Change de modèle en modifiant le chemin de l'URL.
Paiement à la génération
Pas d'abonnement ni de dépense minimale. Tu achètes des Gems, et chaque requête est facturée au prix indiqué. Une génération qui échoue est remboursée, sauf si la politique de contenu de Mage l'a bloquée.
Nouvelles tentatives sans risque
Grâce aux clés d'idempotence, un nouvel envoi renvoie la requête d'origine sans te facturer une deuxième fois.
Personnages cohérents
Enregistre un personnage ou une référence une seule fois, puis écris @handle dans n'importe quel prompt pour l'utiliser avec tous les modèles compatibles.
Fichiers volumineux
Envoie des images, des vidéos et de l'audio sous forme d'URL ou de data URL, ou téléverse des fichiers jusqu'à 100 Mo via un envoi signé.
20 générations en parallèle
Chaque compte peut lancer 20 générations à la fois, et cette limite peut être relevée selon ton usage. Les requêtes refusées ne sont jamais facturées.
Cas d'usage
Ce que les développeurs créent avec l'API vidéo
Vidéo courte et réseaux sociaux
Produis des clips verticaux pour TikTok, Reels et Shorts à partir d'un prompt ou d'une image produit.
Anime tes images fixes
Transforme une première image, ou une première et une dernière image, en mouvement avec des modèles d'image vers vidéo comme Lemon et Kiwi.
Histoires centrées sur des personnages
Garde le même personnage d'un plan à l'autre avec des modèles de référence vers vidéo qui acceptent les personnages @handle.
Vidéo avec son
Plum et d'autres modèles génèrent voix, effets sonores et ambiance avec l'image, et acceptent des références audio pour les voix.
Publicités et démos produit
Génère de nombreuses variantes d'un spot et choisis la meilleure, avec des envois idempotents qui ne facturent jamais deux fois.
Modifie des clips existants
Berry, Plum et Grok Video modifient une vidéo source que tu envoies ; Lemon et MiniMax-H3 acceptent aussi des vidéos de référence.
FAQ
Questions fréquentes
Quelle est la meilleure API de génération de vidéos par IA ?
L'API vidéo prend-elle en charge l'image vers vidéo ?
Quelle peut être la durée des vidéos générées ?
Combien de temps prend la génération d'une vidéo ?
Combien coûte l'API Mage ?
Faut-il un abonnement Mage pour utiliser l'API ?
Puis-je utiliser les résultats de l'API à des fins commerciales ?
Quelles sont les limites de débit ?
Mon agent IA peut-il utiliser l'API Mage ?
Existe-t-il un SDK pour l'API Mage ?
J'utilise déjà une autre API de génération. Que dois-je changer ?
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.