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.

Obtén una clave de APILee la documentación de la API
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.

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
Seed AudioVoces, música y efectos de sonido desde un solo promptseed-audio-1.019 Gems ($0.019)

Inicio rápido

Genera audio con Seed Audio

Configura MAGE_API_KEY, envía la solicitud y consulta el estado hasta que termine. Cambia seed_audio en la URL por cualquiera de los modelos de arriba.

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

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

28 modelos de imagen, vídeo y audio en 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 de la API, así que cualquier cuenta de Mage con Gems puede usarla.

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

Obtén una clave de APILee la documentación de la API

Relacionado