Google

Lyria 3.5

lyria-3.5

Modelo insignia de generación musical de Google: primero planifica la estructura (introducción, estrofa, estribillo, etc.) y luego genera una canción completa con voz y letra; admite canto en varios idiomas y se puede invocar mediante la interfaz unificada de HiAPI.ai

lyria-3.5

Probar lyria-3.5

Entrada

Lyrics

Creaciones

Ver todas las creaciones

Salida

audio

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

lyria-3.5 per song

Precio unitario	$0.090

Descripción general

Lyria 3.5 es un modelo orientado a la generación de música a partir de texto, invocable a través de la interfaz unificada de HiAPI.ai. Puede generar una canción completa a partir de una descripción musical (género, instrumentos, estado de ánimo, estructura), o bien recibir directamente letras con marcas de sección como [Verse] y [Chorus] para ser cantadas, permitiendo especificar la duración, los BPM, el título y una semilla aleatoria. La salida es una canción completa con voz, ideal para desarrolladores que necesitan obtener rápidamente una pieza final bien estructurada, ya sea para musicalizar contenido, crear canciones multilingües o validar demos creativos.

Aspectos destacados

Organiza la canción completa por secciones, no como un ensamblaje de fragmentos: antes de generar, planifica la estructura (introducción, estrofa, estribillo, puente, etc.), logrando una pieza con secciones claras y coherentes entre sí.
Basta con una descripción o con letras para crear la canción: con solo una descripción musical se puede producir una pieza instrumental o vocal; con solo las letras se pasa directamente a la generación del canto.
Duración y velocidad acotables en la solicitud: se puede especificar una duración objetivo de 1 a 240 segundos y un valor numérico de BPM, lo que facilita ajustar la longitud según el espacio de inserción.

Capacidades

Generación de canciones completas a partir de una descripción de texto: con una descripción de hasta 10000 caracteres que indique género, instrumentos, estado de ánimo y estructura, se obtiene directamente una pista completa, reduciendo las tareas de arreglo y edición manual.

Canto impulsado por letras: al enviar letras con marcas de sección se genera una canción con voz, y se puede indicar un título, produciendo una demo de letra y música lista para escuchar.

Duración y velocidad controlables: se puede solicitar una duración objetivo de 1 a 240 segundos y especificar los BPM; la duración real de salida puede diferir del valor solicitado, por lo que conviene diseñar en función de un rango y no de un valor exacto.

Semilla aleatoria e intentos reproducibles: se puede pasar una semilla numérica para organizar varias rondas de generación, pero la misma configuración no garantiza un audio idéntico, por lo que resulta adecuado para explorar variantes y no para una reproducción determinista.

Salida exclusivamente de audio: devuelve un archivo de audio final que puede incorporarse directamente a una biblioteca de materiales o a un flujo de distribución posterior, sin necesidad de conversión de formato.

Casos de uso

Música de fondo para videos cortos y pódcast de creadores de contenido: se introduce una descripción musical del ambiente y el ritmo para obtener una música de fondo que coincida con la duración del montaje final y se coloque directamente en la línea de tiempo de edición.
Demos de audición de letras para músicos: se envían letras con marcas [Verse] y [Chorus] para producir una versión cantada que se puede escuchar, útil para validar ideas de letra y música y comparar versiones.
Música personalizada para publicidad y contenido de marca: se generan pistas originales que encajan con el tono visual a partir de descripciones de género, instrumentos y estado de ánimo, como base musical para materiales publicitarios.
Prototipos de música para videojuegos y medios interactivos: se generan por lotes fragmentos ambientales con descripciones y restricciones de BPM y duración, como prototipos tempranos de música de niveles o interfaces para revisión del equipo.

Limitaciones y recomendaciones de selección

Solo admite entrada de texto y letras, no acepta guía por imágenes; la salida es un archivo de audio con marca de agua y los resultados generados no se pueden almacenar en caché. La duración de cada pista va de segundos a unos minutos, por lo que no es adecuado para casos que requieran música de fondo continua de larga duración o entregas sin pérdida de alta fidelidad. La duración real de salida y los detalles del audio no garantizan coincidir exactamente con los parámetros solicitados, y la misma semilla tampoco reproduce el mismo resultado. Si se necesita edición de audio precisa y controlable, separación de pistas o reproducción determinista, conviene evaluar otras alternativas; esta opción es más adecuada para producir rápidamente canciones finales con estructura completa.

Novedades

Ver el registro de cambios →

Nuevo modelo Nueva documentación de la API lyria-3.5 Sep 11, 2026

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: lyria-3.5

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para lyria-3.5 y la ruta default; consulta la tabla de parámetros a continuación.

bpmstringOpcionalpattern ^[1-9][0-9]*(\.[0-9]+)?$

Opcional, especifica el tempo (BPM) de la pista generada, se pasa como una cadena numérica, con un valor mínimo de 1.

seedstringOpcionalminLength 1pattern ^[0-9]+$

Opcional, semilla aleatoria, se pasa como una cadena numérica; la misma configuración no garantiza generar exactamente el mismo audio.

titlestringOpcional

Opcional, especifica un título para la canción generada.

lengthintegerOpcionalmin 1max 240

Opcional, duración solicitada del audio (en segundos), con un rango de 1 a 240; la duración real de la salida puede diferir de esta.

lyricsstringOpcionalminLength 1pattern \S

Opcional, contenido de la letra, se pueden usar etiquetas de sección como [Verse], [Chorus], etc.; se debe proporcionar al menos uno de los dos: la letra o la descripción musical.

promptstringOpcionalminLength 1maxLength 10000pattern \S

Opcional, descripción musical, utilizada para indicar el estilo, los instrumentos, el estado de ánimo y la estructura; se debe proporcionar al menos uno de los dos: la descripción musical o la letra.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "lyria-3.5",
  "input": {}
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "lyria-3.5",
    input: {}
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "lyria-3.5",
        "input": {}
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}