Une clé, tous les modèles
28 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.
En un coup d’œil
L'API de génération audio de Mage exécute Seed Audio sur https://api.mage.space/v1/seed_audio/generate. Envoyez un prompt, avec ou sans références vocales ou image, et recevez un fichier audio de 120 secondes maximum avec des voix, de la musique ou des effets sonores. Chaque clip se paie en Gems, sans abonnement.
1
modèles audio
$0.019
Option par défaut la moins chère, par clip
20
Générations simultanées
$0
Frais mensuels
Modèles
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 |
|---|---|---|---|
| Seed Audio | Voix, musique et effets sonores à partir d'un seul prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Démarrage rapide
Définissez MAGE_API_KEY, envoyez la requête, puis interrogez le statut jusqu'à la fin du traitement. Remplacez seed_audio dans l'URL par n'importe quel modèle ci-dessus.
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | 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('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
print(request["result"]["url"])Comment ça marche
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.
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.
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 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
28 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.
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.
Grâce aux clés d'idempotence, un nouvel envoi renvoie la requête d'origine sans te facturer une deuxième fois.
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.
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é.
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
Générez la narration de vos vidéos, vidéos explicatives et livres audio, avec des réglages du débit, du volume et de la hauteur.
Enregistrez un clip vocal comme référence et mentionnez-le avec son @handle pour garder la même voix d'un clip à l'autre.
Créez des ambiances, des bruitages et des sons d'interface à partir d'une description, pour vos jeux et applications.
Produisez de la musique de fond pour des clips sociaux et des publicités à partir d'un prompt.
Associez Seed Audio à l'API vidéo pour ajouter du son aux clips produits par des modèles sans audio.
Laissez Claude, ChatGPT ou votre propre agent produire de l'audio via le serveur MCP ou l'API REST.
FAQ
Oui. Seed Audio lit un texte avec une voix décrite ou avec une référence vocale enregistrée, et propose des réglages du débit, du volume et de la hauteur. Il génère aussi de la musique et des effets sonores depuis le même champ de prompt.
Seed Audio génère des clips de 120 secondes maximum.
Il n'y a ni abonnement ni frais mensuels. Chaque génération est payée en Gems au prix indiqué pour son modèle, et 1 000 Gems coûtent 1 $ avec le pack standard. La page de chaque modèle indique son prix avec les réglages par défaut, et chaque réponse précise le montant exact débité. Une génération qui échoue est remboursée ; celle que la politique de contenu de Mage bloque ne l'est pas. Une requête que ton solde ne peut pas couvrir est refusée avant tout débit.
Non. L'API fonctionne uniquement avec des Gems. Les abonnements et leur génération illimitée dans l'appli ne s'appliquent pas aux requêtes API : n'importe quel compte Mage avec des Gems peut donc l'utiliser.
Oui. Tu peux utiliser à des fins commerciales les contenus créés avec Mage, y compris via l'API et le serveur MCP. La mention de la source est appréciée, mais pas obligatoire.
Un compte peut avoir 20 générations en file d'attente ou en cours en même temps. Toute soumission au-delà est refusée avec une erreur 429 et ne coûte rien. Écris à [email protected] pour relever la limite selon ton cas d'usage.
Oui. Les agents peuvent appeler l'API REST avec une clé, ou se connecter au serveur MCP de Mage, qui donne à Claude, ChatGPT, Claude Code, Grok et Cursor seize outils prêts à l'emploi pour choisir un modèle, obtenir le prix, générer et récupérer le résultat. Consulte le serveur MCP.
Oui. Le package officiel @mage-space/sdk sur npm et mage-space sur PyPI sont open source et typés pour chaque modèle. Ils envoient la requête, attendent le résultat, réessaient en toute sécurité et téléversent les fichiers à ta place. Si tu utilises ComfyUI, tu peux installer le pack de nœuds comfyui-mage. Consulte les SDK Mage.
Pointe ton client vers https://api.mage.space/v1, envoie ta clé Mage comme jeton Bearer et associe tes champs à ceux de la page du modèle : prompt, aspect_ratio, resolution, duration et model_id fonctionnent de la même façon pour tous les modèles Mage. Les requêtes sont asynchrones : envoie-les, puis interroge status_url.
Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.