Saltar al contenido

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}/generate

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

ModeloIdeal paraValores de model_idPrecio predeterminado
Eleven MusicCanciones de ElevenLabs, con o sin vozeleven-music-v2.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4: voz realista que puedes dirigireleven-v430 Gems ($0.03)
MiniMax Music 3Canciones completas a partir de tu letra, con pesos abiertosminimax-music-3125 Gems ($0.125)
Seed AudioVoces, música y efectos de sonido desde un solo promptseed-audio-1.019 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.

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

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

  3. 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?
Sí. Seed Audio lee un guion con una voz descrita o con una referencia de voz guardada, y ofrece ajustes de velocidad del habla, volumen y tono. También genera música y efectos de sonido desde el mismo campo de prompt.
¿Cuánto puede durar el audio generado?
Seed Audio genera clips de hasta 120 segundos.
¿Cuánto cuesta la API de Mage?
No hay suscripción ni cuota mensual. Cada generación se paga en Gems al precio indicado de su modelo, y 1000 Gems cuestan 1 $ en el paquete estándar. La página de cada modelo muestra su precio con la configuración por defecto, y cada respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la política de contenido de Mage la bloquea, no. Una solicitud que tu saldo no pueda cubrir se rechaza antes de cobrar nada.
¿Necesito una membresía de Mage para usar la API?
No. La API funciona solo con Gems. Los planes de membresía y su generación ilimitada dentro de la app no se aplican a las solicitudes a la API. Antes, la cuenta necesita un primer pago completado, ya sea un paquete de Gems o un plan; los Gems de bonificación por registrarte solo funcionan en la app de Mage.
¿Puedo usar comercialmente los resultados de la API?
Sí. El contenido que creas con Mage, también a través de la API y el servidor MCP, se puede usar con fines comerciales. Se agradece la atribución, pero no es obligatoria.
¿Cuáles son los límites de uso?
Una cuenta puede tener 20 generaciones en cola o en curso a la vez. Un envío que supere ese límite se rechaza con un 429 y no cuesta nada. Escribe a [email protected] para ampliar el límite según tu caso de uso.
¿Puede mi agente de IA usar la API de Mage?
Sí. Los agentes pueden llamar a la API REST con una clave o conectarse al servidor MCP de Mage, que ofrece a Claude, ChatGPT, Claude Code, Grok y Cursor dieciséis herramientas listas para usar para elegir un modelo, consultar el precio, generar y obtener el resultado. Consulta el servidor MCP.
¿Hay un SDK para la API de Mage?
Sí. El paquete oficial @mage-space/sdk en npm y mage-space en PyPI son de código abierto y tienen tipado para cada modelo. Envían la solicitud, esperan el resultado, reintentan de forma segura y suben archivos por ti. Los usuarios de ComfyUI pueden instalar el paquete de nodos comfyui-mage. Consulta los SDK de Mage.
Ya uso otra API de generación. ¿Qué tengo que cambiar?
Apunta tu cliente a https://api.mage.space/v1, envía tu clave de Mage como token Bearer y asigna tus campos a los de la página del modelo: prompt, aspect_ratio, resolution, duration y model_id funcionan igual en todos los modelos de Mage. Las solicitudes son asíncronas, así que envíala y luego consulta status_url.

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

CharactersComunidad