Saltar al contenido
PlaygroundDocumentaciónObtener clave de API

API de Mage · Modelo de audio

API de Eleven Music

Canciones de ElevenLabs, con o sin voz

Obtén una clave de APIPrueba Eleven Music en el playground
POST https://api.mage.space/v1/eleven_music/generate

De un vistazo

La API de Eleven Music ejecuta Eleven Music v2.5 a través de Mage en POST https://api.mage.space/v1/eleven_music/generate. Una solicitud con los ajustes predeterminados cuesta 113 Gems (unos $0.113), sin suscripción. Eleven Music no admite menciones con @handle.

  • AudioResultado
  • 1Variante
  • 113Gems por clip, predeterminado
  • $0.113Aprox., en USD

Resumen

Qué hace la API de Eleven Music

Eleven Music de ElevenLabs: canciones con letra y voz, o instrumentales, a partir de una descripción, con la duración exacta que elijas, de hasta 5 minutos.

El modelo de música de ElevenLabs: canciones con voz o instrumentales, en un MP3 con exactamente la duración pedida. ElevenLabs rechaza los prompts que nombran a un artista o citan letras con derechos de autor; la solicitud falla y se reembolsa.

Genera solo a partir del prompt.

Inicio rápido

Llama a la API de Eleven Music

Define MAGE_API_KEY, envía la solicitud a /eleven_music/generate y consulta status_url hasta que termine.

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

Modelos

Valores de model_id de Eleven Music

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
eleven-music-v2.5Eleven Music v2.5Sí

Opciones

Parámetros de Eleven Music

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

CampoValores
duration10, 30, 60, 120, 180, 300

Reglas

Qué exige la API de Eleven Music

  • El prompt describe la canción, con un máximo de 2000 caracteres.

Más modelos de audio

Otras API de generación de audio en Mage

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Eleven Music?
Una solicitud de Eleven Music con los ajustes predeterminados (Eleven Music v2.5) cuesta 113 Gems, unos $0.113. 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 Eleven Music?
POST https://api.mage.space/v1/eleven_music/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 Eleven Music puedo usar?
eleven-music-v2.5 (Eleven Music v2.5). El predeterminado es Eleven Music v2.5.
¿Eleven Music admite imágenes de referencia o personajes?
Eleven Music no admite entradas de imagen, video ni audio. Eleven Music no admite menciones con @handle.
¿Puedo usar Eleven Music desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Eleven Music por su nombre. Tu asistente lee sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Eleven Music?
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.

Obtén una clave de APIPrueba Eleven Music en el playground