Introducción
Describe la música en prompt, incluido el arreglo que deseas y una duración aproximada. Lyria 3.5 entrega un MP3 estéreo de 44,1 kHz y cobra por pista, sin importar la duración. La prueba de folk acústico proporcionada pidió 30 segundos y recibió 61,6 segundos de audio.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Audio |
| Modelo musical | Google DeepMind Lyria 3.5 |
| Entrada admitida | prompt |
| Archivo recibido | Una pista MP3, estéreo de 44,1 kHz |
| Codificación medida | Unos 193 kbps |
| Tratamiento de la duración | Indicación aproximada en el prompt; sin campo de duración |
| Unidad facturable | Una pista generada, sin depender de su duración |
Funciones y aspectos destacados
Reúne las decisiones musicales en una descripción
Género, ambiente, instrumentos, tempo, estructura y duración deseada se escriben en el prompt. Para una apertura de podcast, define un arreglo discreto y un motivo inicial; para un montaje de video, describe cómo debe subir y bajar la energía. Así tendrás detalles concretos que buscar al escuchar la pista recibida.
Planea el corte después de escuchar la pista
La prueba de folk acústico pidió un instrumental de 30 segundos a 100 BPM y devolvió un MP3 de 61,6 segundos en unos 30 segundos. Usa ese dato para reservar una etapa de escucha y recorte. No demuestra un control de duración exacta ni un tiempo de procesamiento habitual para distintos géneros.
Incorpora un MP3 estéreo al proyecto
Cada generación entrega una pista MP3 estéreo de 44,1 kHz; la prueba proporcionada registró unos 193 kbps. Contrasta el inicio, el desarrollo y el final con tu propuesta musical. Si el podcast o anuncio tiene narración, escucha la música junto con esa voz antes de aprobar la mezcla.
Calcula las variaciones según la cantidad de pistas
La unidad de cobro es la pista generada y no aumenta con su duración. Consulta la tarifa publicada y decide qué variaciones del prompt vale la pena generar. Pedir una pieza más corta cambia las indicaciones musicales, pero mantiene la unidad de facturación.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe género, ambiente, instrumentos, tempo y desarrollo de principio a fin. mínimo 1 caracteres · máximo 5000 caracteres |
image_url | No | No se admite en este endpoint; omite |
Precios
$0.12 / canción
Se cobra una vez por canción generada, sin depender de su duración. Las generaciones fallidas no se cobran; consulta la tarifa por pista que aparece en esta página.
Casos de uso
Música de fondo para un video
Para un montaje de senderismo, pide un instrumental de folk acústico animado a 100 BPM, con guitarra punteada, percusión ligera y un final suave. Recibirás un MP3 para probarlo con las imágenes y recortarlo a la edición.
Una apertura para un podcast
Para un podcast semanal de ciencia, describe un instrumental electrónico de carácter curioso a 90 BPM, con notas redondas de sintetizador, batería discreta y un motivo inicial breve. La pista resultante aporta material para una entrada bajo el saludo hablado.
Un pasaje repetible para un juego
Para un nivel de acertijos, solicita música ambiental tranquila a 80 BPM con marimba suave, capas sostenidas y una sección repetida. Descarga el MP3, elige un pasaje útil y revisa o funde los extremos del bucle en un editor de audio.
Una base musical publicitaria
Para una demostración de artículos para el hogar, pide pop instrumental luminoso a 110 BPM, con guitarra apagada, bajo ligero y poca percusión. Prueba el MP3 recibido como base musical y comprueba que deje espacio a la narración.
Un boceto de ambiente antes de producir
Para una escena nocturna tranquila, describe un instrumental de piano reflexivo a 70 BPM que empiece con pocas notas y sume cuerdas cálidas hacia el final. La pista ofrece una dirección musical para revisar antes de preparar la partitura definitiva.
Guía de prompts y consejos prácticos
Define la propuesta musical
Escribe un prompt con género, ambiente, instrumentos concretos, tempo y una estructura de principio a fin. Incluye una duración orientativa e indica «instrumental» si ese es el resultado que buscas.
Solicita la generación
Envía POST a https://api.spicyapi.ai/api/v1/jobs/createTask con autenticación Bearer y JSON {"model":"google/lyria-3.5/text-to-audio","input":{"prompt":"Calm acoustic folk instrumental, 100 BPM, picked guitar, soft percussion, gentle ending; aim for 30 seconds."}}.
Obtén la pista terminada
Conserva data.taskId y consulta GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID con la clave API que creó la tarea. Cuando data.state sea succeeded, recupera el MP3 desde data.output.assets[0].url.
Verifica la duración en tu edición
Escucha todo el arreglo y mide la duración del archivo antes de colocarlo en la línea de tiempo. Modifica el prompt si quieres otra dirección musical o recorta la pista cuando necesites un cierre exacto.
Lyria 3.5 API para convertir texto en música
Lyria 3.5 de Google DeepMind genera una pista musical a partir de una propuesta escrita y entrega un MP3 mediante este endpoint de texto a audio. Describe género, ambiente, instrumentos, tempo, estructura y duración deseada en prompt para orientar la composición.
Google afirma que el lanzamiento de Lyria 3.5 mejoró la musicalidad, el tratamiento de las letras y la expresión vocal. La prueba de folk acústico de abajo mide duración y tiempo de procesamiento.
Envía una solicitud musical
Envía google/lyria-3.5/text-to-audio con la propuesta musical en input.prompt. Este cuerpo ilustrativo es distinto del prompt utilizado en la prueba medida:
{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Gentle acoustic folk instrumental, 100 BPM, picked guitar, warm bass and brushed percussion. Begin with guitar, add a restrained rhythm section, then close softly. Aim for 30 seconds."
}
}
- Envía ese cuerpo a
POST https://api.spicyapi.ai/api/v1/jobs/createTaskconAuthorization: Bearer YOUR_API_KEYyContent-Type: application/json. - Guarda
data.taskIdde la respuesta de aceptación. - Consulta
GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_IDcon la clave API que creó la tarea hasta que alcance un estado final. - Cuando llegue a
succeeded, descargadata.output.assets[0].url.
Lee el resultado de la tarea
La aceptación de la tarea devuelve un ID antes de que la música esté disponible. Estas respuestas abreviadas usan identificadores de muestra y una dirección de archivo ilustrativa:
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "queued"
}
}
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "succeeded",
"output": {
"assets": [
{"url": "https://example.com/your-track.mp3"}
]
}
}
}
Consulta la documentación de la API de tareas para conocer la respuesta completa. Comprueba el estado final antes de tratar el registro recibido como una pista utilizable.
Parámetros e indicaciones musicales
prompt contiene los controles musicales que ofrece este endpoint. El tempo y la duración se expresan en ese texto, sin campos numéricos independientes.
| Campo o indicación | Cómo utilizarlo |
|---|---|
prompt | Envía la propuesta musical como texto. |
| Género y ambiente | Nombra un estilo y una sensación, por ejemplo, folk acústico reflexivo. |
| Instrumentos | Identifica el instrumento principal y las partes de acompañamiento. |
| Tempo | Escribe los BPM o el ritmo deseado en la descripción. |
| Estructura | Describe el inicio, el desarrollo y el cierre. |
| Duración deseada | Indica el tiempo que buscas; verifica la duración recibida. |
| Campos no admitidos | Omite image_url, duration, seed y los controles de formato de salida. |
Consigue una pista adecuada para el proyecto
Una descripción concreta del arreglo aporta criterios claros para revisar la música. Para una base publicitaria, pide instrumentación discreta y escúchala con la narración real; para un juego, solicita un pasaje repetido y edita después los extremos del bucle.
- Especifica «instrumental» cuando quieras música sin canto.
- Elige un instrumento principal y un pequeño conjunto de apoyo para dejar clara la mezcla buscada.
- Describe los cambios de energía en vez de acumular adjetivos de ambiente sin relación.
- Cambia una parte de la propuesta entre tomas y compara ese detalle musical.
- Guarda el MP3 aprobado junto con su prompt para conservar la toma elegida.
Lo que mostró la prueba de folk acústico
La prueba de folk acústico instrumental devolvió 61,6 segundos de música tras pedir 30 segundos a 100 BPM. La generación tardó aproximadamente 30 segundos; se recibió un MP3 estéreo de 44,1 kHz a unos 193 kbps.
| Condición o medición de la prueba | Valor registrado |
|---|---|
| Propuesta | Instrumental neutral de folk acústico |
| Tempo solicitado | 100 BPM |
| Duración pedida | 30 segundos |
| Duración real | 61,6 segundos |
| Tiempo de procesamiento | Unos 30 segundos |
| Audio | MP3, estéreo de 44,1 kHz, unos 193 kbps |
Este único resultado muestra un seguimiento aproximado de la duración, sin establecer latencias habituales ni calidad entre estilos musicales. Escucha el archivo completo para revisar los cambios de arreglo, luego mídelo y recórtalo antes de sincronizarlo con un corte preciso de video o una apertura de podcast.
Precio por pista generada
Se factura por pista, independientemente de su duración. Consulta la tarifa que aparece en esta página para presupuestar variaciones del prompt; pedir una pieza más corta no cambia la unidad de cobro. Una generación que no termina correctamente no genera un cargo por pista.
Límites y diagnóstico de problemas
Si la música se extiende demasiado, debes editarla, ya que este endpoint no tiene un ajuste específico de duración. Cuando falle una solicitud, comprueba que input contenga el campo prompt admitido y revisa el error recibido antes de enviar una descripción modificada.
Google explica que sus filtros musicales bloquean solicitudes de voces de artistas específicos o letras protegidas por derechos de autor. Describe cualidades musicales y usa textos y voces que tengas derecho a utilizar; nunca suplantes a una persona real. La ficha del modelo de Google también describe la marca de agua SynthID.
Elige un modelo relacionado para otro flujo de trabajo
Usa este endpoint para descargar una pista cuyo arreglo y duración aproximada se describen con texto. Sigue los enlaces de Google para evaluar Clip para piezas cortas o RealTime para transmisión continua.
| Necesidad | Opción que puedes evaluar |
|---|---|
| Un MP3 guiado por texto para una línea de tiempo de edición | Lyria 3.5 text-to-audio |
| Un clip musical fijo de 30 segundos | Según Google, Lyria 3 Clip genera clips de 30 segundos. |
| Música instrumental dirigida durante la reproducción | Google describe Lyria RealTime como un modelo de transmisión interactiva. |
| Un corte exacto o un bucle preparado | Recorta o aplica un fundido cruzado a la pista descargada en un editor de audio. |
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
