L'API de génération de vidéos par IA, à partir de texte ou d'images

En un coup d’œil

L'API de génération de vidéos de Mage est une API REST disponible sur https://api.mage.space/v1, qui exécute 12 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. Envoie un prompt et, en option, des images ou des références, interroge la requête, puis télécharge un MP4. Chaque clip se paie en Gems selon le modèle, la résolution et la durée.

• 12

  modèles vidéo

• $0.02

  Option par défaut la moins chère, par clip

• 20

  Générations simultanées

• $0

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

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.

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

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.

1. 01

   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.

2. 02

   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.

3. 03

   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

Cas d'usage

Ce que les développeurs créent avec l'API vidéo

FAQ

Questions fréquentes

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.

À voir aussi

• API de génération d'images IA
• API de génération audio IA
• Serveur MCP Mage
• SDK Mage
• Mage pour ComfyUI
• Tous les modèles de l'API
• Playground de l'API
• Documentation de l'API