De un vistazo
La API de Seed Audio ejecuta Seed Audio a través de Mage en POST https://api.mage.space/v1/seed_audio/generate. Una solicitud con los ajustes predeterminados cuesta 19 Gems (unos 0,019 $), sin suscripción. Seed Audio admite referencias de audio guardadas mediante @handle en el prompt.
Audio
Resultado
1
Variante
19
Gems por clip, predeterminado
$0.019
Aprox., en USD
Resumen
Qué hace la API de Seed Audio
Voz, diálogos, música y efectos de sonido a partir de un solo prompt, en un MP3 con la duración exacta que pidas, de 5 segundos a 2 minutos. Imita una voz a partir de hasta 3 clips de audio.
Voces, diálogos, música y efectos de sonido a partir de un solo prompt, en un MP3 con la duración exacta solicitada.
Acepta image como entrada.
Inicio rápido
Llama a la API de Seed Audio
Define MAGE_API_KEY, envía la solicitud a /seed_audio/generate y consulta status_url hasta que se complete.
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"])Modelos
Valores de model_id de Seed Audio
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| seed-audio-1.0 | Seed Audio | Sí |
Opciones
Parámetros de Seed Audio
Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.
| Campo | Valores |
|---|---|
| duration | 5, 10, 30, 60, 120 |
Entradas
Entradas multimedia que acepta Seed Audio
Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.
| Campo | Rol |
|---|---|
| image | La imagen de referencia. |
Reglas
Qué reglas aplica la API de Seed Audio
- Una referencia de imagen no se puede combinar con referencias de audio: envía solo un tipo.
- El prompt tiene un máximo de 2986 caracteres.
- `sample_rate` es uno de estos valores: 8000, 16000, 24000, 32000, 44100, 48000.
- `speech_rate` es un número entero de -50 a 100.
- `loudness_rate` es un número entero de -50 a 100.
- `pitch_rate` es un número entero de -12 a 12.
Más modelos de audio
Otras API de generación de audio en Mage
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Seed Audio?
Una solicitud de Seed Audio con los ajustes predeterminados (Seed Audio) cuesta 19 Gems, unos 0,019 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de Seed Audio?
POST https://api.mage.space/v1/seed_audio/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye un status_url para consultar el resultado.
¿Qué modelos de Seed Audio puedo llamar?
seed-audio-1.0 (Seed Audio). El predeterminado es Seed Audio.
¿Seed Audio admite imágenes de referencia o personajes?
Seed Audio acepta image. Seed Audio admite referencias de audio guardadas mediante @handle en el prompt.
¿Puedo usar Seed Audio desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Seed Audio por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Seed Audio?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.