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.

Obtenir une clé d'APILire la doc de l'API
POST https://api.mage.space/v1/{model}/generate

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.

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èleIdéal pourValeurs de model_idPrix par défaut
Seed AudioVoix, musique et effets sonores à partir d'un seul promptseed-audio-1.019 Gems ($0.019)

Démarrage rapide

Générer de l'audio avec Seed Audio

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.

cURL
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"
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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.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("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

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

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.

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 ?

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.

Quelle peut être la durée de l'audio généré ?

Seed Audio génère des clips de 120 secondes maximum.

Combien coûte l'API Mage ?

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.

Faut-il un abonnement Mage pour utiliser l'API ?

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.

Puis-je utiliser les résultats de l'API à des fins commerciales ?

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.

Quelles sont les limites de débit ?

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.

Mon agent IA peut-il utiliser l'API Mage ?

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.

Existe-t-il un SDK pour l'API Mage ?

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.

J'utilise déjà une autre API de génération. Que dois-je changer ?

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.

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.

Obtenir une clé d'APILire la doc de l'API

À voir aussi