Google

Lyria 3 Pro

lyria-3-pro

Modelo avanzado de generación musical de Google, capaz de generar piezas completas de unos 3 minutos en estéreo a 48 kHz, comprende la estructura de secciones como introducción, verso y estribillo, y sigue las instrucciones mejor que Lyria 3

lyria-3-pro

Probar lyria-3-pro

Entrada

Creaciones

Ver todas las creaciones

Salida

audio

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

Precios

lyria-3-pro per song

Precio unitario	$0.140

Descripción general

lyria-3-pro es un modelo de generación de música a partir de texto lanzado por Google, dirigido a desarrolladores que necesitan canciones completas en lugar de fragmentos. Describe en el prompt el estilo musical, los instrumentos, el estado de ánimo, el tempo, la letra y la estructura de la canción, y puede incluir marcas de tiempo para guiar la organización de las secciones; además, admite hasta 10 imágenes para orientar la dirección creativa. Es adecuado para equipos que generan bandas sonoras originales por lotes para vídeos, juegos, contenido social y proyectos de marca, y puede integrarse en los flujos de producción existentes mediante la interfaz unificada de HiAPI.ai.

Aspectos destacados

Genera canciones completas con estructura definida: permite especificar en el prompt secciones como intro, estrofa, estribillo y puente, junto con marcas de tiempo, para producir una canción completa con inicio y final claros en lugar de fragmentos en bucle.
Mayor fidelidad al prompt: como versión Pro, reproduce con mayor precisión el estilo musical, los instrumentos y la intención de arreglo, lo que reduce el coste de ajustes por reintentos repetidos.
Las imágenes pueden orientar la dirección creativa: se pueden subir hasta 10 imágenes por generación como referencia de ambiente y temática, trasladando el tono del material visual a la generación musical.
Reproducibilidad mediante semilla: admite el parámetro seed para realizar intentos de generación reproducibles, lo que facilita controlar las variables durante la iteración.

Capacidades

Generación de música a partir de texto: describe con un prompt el estilo musical, los instrumentos, el estado de ánimo, el tempo, la letra y la estructura de la canción para obtener directamente una salida de audio original utilizable.

Control de arreglo estructurado: en el prompt se pueden usar marcas de tiempo como [0:00 - 0:30] para delimitar el inicio y el final de las secciones, de modo que el resultado generado se ajuste al ritmo narrativo previsto.

Guía mediante imágenes: se pueden proporcionar de 1 a 10 imágenes como referencia de inspiración para orientar el estado de ánimo, la temática y la dirección general del arreglo de la obra; las imágenes en sí no constituyen material visual de la salida.

Generación reproducible: ofrece el parámetro seed para una generación reproducible, lo que facilita comparar ajustes bajo la misma configuración, aunque no garantiza una determinación estricta.

Casos de uso

Equipos de producción de vídeo: generar banda sonora según el guion gráfico: incorpora el ritmo de los planos y la descripción del estado de ánimo en el prompt para producir música original que coincida con la duración del vídeo y pase directamente al montaje y la posproducción.
Desarrolladores de juegos: música de fondo personalizada: describe el estilo musical y la estructura de secciones según la atmósfera del nivel y las necesidades de bucle para generar material de BGM original integrable en el juego.
Marcas y creadores de redes sociales: música temática personalizada: usa como entrada descripciones del tono de marca o imágenes de referencia para generar música exclusiva afinada al contenido, destinada a anuncios y contenido social.
Desarrolladores de herramientas: integrar capacidades de generación musical: integra la generación de música a partir de texto en tus propias herramientas creativas o plataformas de contenido mediante la interfaz unificada de HiAPI.ai, para ofrecer capacidades de generación a los usuarios finales.

Limitaciones y recomendaciones de selección

La duración máxima por generación es de aproximadamente 3 minutos; las obras que superen esa longitud requieren generar por segmentos y unirlos después, además de edición manual en posproducción para alcanzar el resultado final. Solo produce audio, sin capacidades de imagen o vídeo. Cuanto más concreto sea el prompt, más fácil será obtener resultados utilizables; las descripciones vagas pueden requerir varias iteraciones. La semilla puede mejorar la reproducibilidad, pero no es estrictamente determinista. Si solo se necesitan fragmentos cortos o material de audición más ligero, se pueden considerar modelos de la misma serie como Lyria 3.

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-pro

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcionalmin 0

Semilla aleatoria opcional para obtener resultados de generación reproducibles; una misma semilla no garantiza una salida completamente determinada.

promptstringObligatoriominLength 1

Indicación de texto para describir el estilo musical, los instrumentos, el estado de ánimo, el tempo, la letra y la estructura de la canción; se pueden añadir marcas de tiempo con el formato [0:00 - 0:30] para guiar el desarrollo del arreglo.

image_urlsarrayOpcionalminItems 1maxItems 10

Array opcional de imágenes de inspiración para orientar el estado de ánimo, la temática y la instrumentación de la música; estas imágenes no son fotogramas visuales ni material de origen de la salida de audio.

Array [ string ]

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-pro",
  "input": {
    "prompt": "…"
  }
}'

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-pro",
    input: {
      "prompt": "…"
    }
  }),
});
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-pro",
        "input": {
          "prompt": "…"
        }
    },
)
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"
    }
  }
}