API de Mage · Generación de audio
La API de generación de audio con IA para voces, música y sonido
Voz, narración, música y efectos de sonido desde un solo prompt con Seed Audio, con referencias de voz y controles de velocidad del habla, volumen y tono.
POST https://api.mage.space/v1/{model}/generateDe un vistazo
La API de generación de audio de Mage ejecuta Seed Audio en https://api.mage.space/v1/seed_audio/generate. Envía un prompt de texto, con referencias de voz o una imagen si quieres, y recibe un archivo de audio de hasta 120 segundos con voces, música o efectos de sonido. Cada clip se paga en Gems, sin suscripción.
- 4modelos de audio
- $0.019Opción más barata por defecto, por clip
- 20Generaciones simultáneas
- $0Cuota mensual
Modelos
Todos los modelos de audio de la API de Mage
Los precios son por generación, en Gems. 1.000 Gems cuestan 1 USD en el paquete estándar, y los paquetes más grandes incluyen Gems extra. El precio depende del modelo, la resolución y la duración; se muestra el precio con los ajustes predeterminados, y cada respuesta indica el cargo exacto en billing.gems_charged. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
| Modelo | Ideal para | Valores de model_id | Precio predeterminado |
|---|---|---|---|
| Eleven Music | Canciones de ElevenLabs, con o sin voz | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: voz realista que puedes dirigir | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Canciones completas a partir de tu letra, con pesos abiertos | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Voces, música y efectos de sonido desde un solo prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Inicio rápido
Genera audio con Eleven Music v2.5
Define MAGE_API_KEY, envía la solicitud y consulta el estado hasta que termine. Cambia eleven_music en la URL por cualquier modelo de arriba.
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"])Cómo funciona
De la clave de API al contenido final en tres llamadas
Todos los modelos comparten un único esquema de autenticación, un mismo ciclo de solicitudes asíncronas y los mismos nombres de campo.
Crea una clave de API
Inicia sesión en Mage, abre API → API Keys y crea una clave. Empieza por mage_sk_ y se muestra una sola vez. Una cuenta puede tener 10 claves activas.
Envía una generación
Haz un POST con un cuerpo JSON a https://api.mage.space/v1/{model}/generate con una cabecera Authorization: Bearer. La respuesta llega al instante con un request_id, un status y una status_url. Envía una cabecera Idempotency-Key para que un reintento nunca se cobre dos veces.
Consulta y descarga
Consulta status_url hasta que el estado sea completed, failed o cancelled. Una solicitud completada incluye result.url con el archivo de imagen, vídeo o audio, que se conserva 30 días.
Pensada para producción
Lo que obtiene cada solicitud a la API de Mage
Una clave, todos los modelos
37 modelos de imagen, video y audio con una sola API REST y un único saldo de Gems. Cambia de modelo modificando la ruta de la URL.
Paga por generación
Sin suscripción ni gasto mínimo. Compras Gems y cada solicitud se cobra a su precio indicado. Si una generación falla, se reembolsa, salvo que la política de contenido de Mage la haya bloqueado.
Reintentos seguros
Las claves de idempotencia hacen que un reenvío devuelva la solicitud original sin volver a cobrar.
Personajes coherentes
Guarda un personaje o una referencia una vez y escribe @handle en cualquier prompt para usarlo con todos los modelos compatibles.
Entradas de gran tamaño
Envía entradas de imagen, vídeo y audio como URL o data URL, o sube archivos de hasta 100 MB mediante una subida firmada.
20 generaciones en curso
Cada cuenta puede ejecutar 20 generaciones a la vez, y el límite se puede ampliar según tu caso de uso. Las solicitudes rechazadas nunca se cobran.
Casos de uso
Qué crean los desarrolladores con la API de audio
Narración y locución
Genera narraciones para vídeos, explicaciones y audiolibros, con controles de velocidad del habla, volumen y tono.
Voces coherentes
Guarda un clip de voz como referencia y menciónalo con su @handle para mantener la misma voz en todos los clips.
Efectos de sonido
Crea ambientes, foley y sonidos de interfaz a partir de una descripción para juegos y apps.
Música de fondo
Produce música de fondo para clips de redes sociales y anuncios a partir de un prompt.
Bandas sonoras para vídeo generado
Combina Seed Audio con la API de vídeo para añadir sonido a clips de modelos sin audio.
Agentes que hablan
Deja que Claude, ChatGPT o tu propio agente produzcan audio a través del servidor MCP o la API REST.
Preguntas frecuentes
Preguntas frecuentes
¿Puede la API de audio convertir texto en voz?
¿Cuánto puede durar el audio generado?
¿Cuánto cuesta la API de Mage?
¿Necesito una membresía de Mage para usar la API?
¿Puedo usar comercialmente los resultados de la API?
¿Cuáles son los límites de uso?
¿Puede mi agente de IA usar la API de Mage?
¿Hay un SDK para la API de Mage?
Ya uso otra API de generación. ¿Qué tengo que cambiar?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.