API Mage · Génération audio
L'API de génération audio par IA pour les voix, la musique et les sons
Parole, narration, musique et effets sonores à partir d'un seul prompt avec Seed Audio, avec références vocales et réglages du débit, du volume et de la hauteur.
POST https://api.mage.space/v1/{model}/generateEn 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.
- 4modèles audio
- $0.019Option par défaut la moins chère, par clip
- 20Générations simultanées
- $0Frais mensuels
Modèles
Tous les modèles audio 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 |
|---|---|---|---|
| Eleven Music | Des chansons ElevenLabs, avec ou sans voix | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4 : une voix réaliste que tu peux diriger | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Des chansons complètes à partir de tes paroles, poids ouverts | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Voix, musique et effets sonores à partir d'un seul prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Démarrage rapide
Génère de l'audio avec Eleven Music v2.5
Définis MAGE_API_KEY, envoie la requête, puis interroge l'état jusqu'à la fin. Remplace eleven_music dans l'URL par n'importe quel modèle ci-dessus.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
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 audio
Narration et voix off
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.
Des voix cohérentes
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.
Effets sonores
Créez des ambiances, des bruitages et des sons d'interface à partir d'une description, pour vos jeux et applications.
Fonds musicaux
Produisez de la musique de fond pour des clips sociaux et des publicités à partir d'un prompt.
Bandes-son pour vidéos générées
Associez Seed Audio à l'API vidéo pour ajouter du son aux clips produits par des modèles sans audio.
Des agents qui parlent
Laissez Claude, ChatGPT ou votre propre agent produire de l'audio via le serveur MCP ou l'API REST.
FAQ
Questions fréquentes
L'API audio peut-elle faire de la synthèse vocale ?
Quelle peut être la durée de l'audio généré ?
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.