API Seed Audio

En un coup d’œil

L'API Seed Audio exécute Seed Audio via Mage à l'adresse POST https://api.mage.space/v1/seed_audio/generate. Une requête avec les réglages par défaut coûte 19 Gems (environ 0,019 $), sans abonnement. Seed Audio accepte des références audio enregistrées via @handle dans le prompt.

• Audio

  Sortie

• 1

  Variante

• 19

  Gems par clip, par défaut

• $0.019

  Environ, en USD

Présentation

Ce que fait l'API Seed Audio

Voix, dialogues, musique et effets sonores à partir d'un seul prompt, sous forme de MP3 de la durée exacte demandée, de 5 secondes à 2 minutes. Reproduis une voix à partir de 3 clips audio maximum.

Voix, dialogues, musique et effets sonores à partir d'un seul prompt, sous forme de MP3 de la durée exacte demandée.

Il accepte image en entrée.

Démarrage rapide

Appeler l'API Seed Audio

Définis MAGE_API_KEY, envoie ta requête à /seed_audio/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.

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

Modèles

Valeurs de model_id pour Seed Audio

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

Options

Paramètres de Seed Audio

Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.

Entrées

Médias acceptés par Seed Audio

Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.

Règles

Ce que l'API Seed Audio impose

• Une référence image ne peut pas être combinée avec des références audio : envoie l'un ou l'autre.
• Le prompt contient au maximum 2986 caractères.
• `sample_rate` vaut l'une de ces valeurs : 8000, 16000, 24000, 32000, 44100, 48000.
• `speech_rate` est un nombre entier compris entre -50 et 100.
• `loudness_rate` est un nombre entier compris entre -50 et 100.
• `pitch_rate` est un nombre entier compris entre -12 et 12.

Plus de modèles audio

Autres API de génération audio sur Mage

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 audio IA
• Référence de l'API Seed Audio
• Playground Seed Audio
• Tous les modèles de l'API
• Serveur MCP Mage