Crear música para anuncios de comercio electrónico con lyria-3.5 (en lugar de imágenes de producto)

Lyria 3.5 genera música, no fotos de producto: así es la forma correcta de usarlo para comercio electrónico

Si has buscado "imágenes de producto con lyria-3.5", la respuesta breve es: lyria-3.5 es el modelo de texto a música de hiapi: no puede generar fotos de producto. No tiene salida de imagen, no tiene el campo image_urls y no hay absolutamente nada relacionado con lo visual en su esquema. Su verdadero uso es la música de fondo y las bandas sonoras, y para los vendedores de comercio electrónico esta es precisamente una necesidad real y poco cubierta: todo video de producto, anuncio y clip para redes sociales necesita música, y la música de stock con licencia es más lenta y más cara de lo que la mayoría de los equipos espera.

Esta guía muestra el escenario que realmente funciona: usar lyria-3.5 para generar música de fondo libre de regalías para videos de producto y anuncios de comercio electrónico, con una solicitud real, una respuesta real y la pista real que generamos para este artículo.

Por qué este escenario encaja con lyria-3.5

La descripción oficial del modelo lyria-3.5 de hiapi menciona explícitamente la publicidad como caso de uso previsto, junto con podcasts y demos de indie pop. No es una interpretación forzada nuestra, sino el posicionamiento de la propia plataforma. La música para anuncios de comercio electrónico encaja perfectamente en esta categoría:

• Videos de demostración de producto (estilo Shopify/TikTok Shop) necesitan una base instrumental de 15–40 segundos que no compita con la narración de voz.
• Anuncios en redes sociales de pago necesitan un estado de ánimo "alegre y energético" para transmitir una promoción o un lanzamiento, evitando al mismo tiempo los problemas de licencias.
• Listas de reproducción de fondo para la tienda (ventas en directo, video dentro de la aplicación) necesitan variedad sin tener que pagar una tarifa de licencia de sincronización por cada pista.

Lyria 3.5 puede generar una pieza instrumental completa a partir de un prompt de texto en aproximadamente un minuto (o una pista vocal si proporcionas la letra), por 0,09 USD por canción: lo bastante barato como para generar varias variantes por campaña y elegir la mejor, que es exactamente la forma correcta de usar un modelo de música generativa: como borrador, no como material final de una sola vez.

Una generación real: prompt, solicitud, respuesta

A continuación, el prompt exacto que utilizamos y la pista exacta que generó, sin editar ni seleccionar de un lote.

Prompt:

Upbeat modern electronic-pop instrumental for an e-commerce product ad, bright plucked synths, punchy four-on-the-floor beat, warm bass groove, optimistic and energetic mood, radio-ready polish, no vocals

Solicitud (la API unificada de tareas asíncronas de hiapi):

curl -s -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": {
      "prompt": "Upbeat modern electronic-pop instrumental for an e-commerce product ad, bright plucked synths, punchy four-on-the-floor beat, warm bass groove, optimistic and energetic mood, radio-ready polish, no vocals"
    }
  }'

Esto devuelve inmediatamente un ID de tarea; la generación de música se ejecuta de forma asíncrona, igual que con los modelos de imagen y video de hiapi.

Sondeo hasta el estado final:

curl -s https://api.hiapi.ai/v1/tasks/tk-hiapi-01M2HM4T0RG0XQNS6TFE9QF14V \
  -H "Authorization: Bearer $HIAPI_API_KEY"

Respuesta al completarse (resumida):

{
  "id": "tk-hiapi-01M2HM4T0RG0XQNS6TFE9QF14V",
  "status": "success",
  "output": [
    {
      "title": "Bright Shelf",
      "url": "https://temp.hiapi.ai/7c6ttvrbpt/01M2HM4T0RG0XQNS6TFE9QF14V-0.m4a"
    }
  ],
  "expireAt": 1790050272
}

Escucha el resultado real aquí: Bright Shelf — salida de lyria-3.5 (.m4a). Este enlace es una URL de salida temporal que caduca aproximadamente 7 días después de la generación; si quieres conservar el archivo, descárgalo y vuelve a alojarlo. Esto es el procedimiento estándar para todas las salidas de tareas de hiapi, incluido el audio: obtén los bytes en cuanto se complete la tarea y guárdalos en tu propio bucket.

El modelo nombró la pista por sí mismo como "Bright Shelf": lyria-3.5 genera automáticamente un título corto junto al audio, un detalle interesante si estás organizando una biblioteca musical para una campaña.

Código equivalente en Python

import requests
import time

API_KEY = "your-hiapi-key"
BASE = "https://api.hiapi.ai/v1"

resp = requests.post(f"{BASE}/tasks", headers={"Authorization": f"Bearer {API_KEY}"}, json={
    "model": "lyria-3.5",
    "input": {
        "prompt": "Upbeat modern electronic-pop instrumental for an e-commerce product ad, "
                  "bright plucked synths, punchy four-on-the-floor beat, warm bass groove, "
                  "optimistic and energetic mood, radio-ready polish, no vocals"
    }
})
task_id = resp.json()["id"]

while True:
    task = requests.get(f"{BASE}/tasks/{task_id}", headers={"Authorization": f"Bearer {API_KEY}"}).json()
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    audio_url = task["output"][0]["url"]
    audio_bytes = requests.get(audio_url).content
    with open("bright_shelf.m4a", "wb") as f:
        f.write(audio_bytes)

Esquema: qué acepta realmente lyria-3.5

El esquema está deliberadamente diseñado para ser muy limitado: es un modelo de texto a música, no un conjunto de herramientas de audio de propósito general:

• prompt (string): obligatorio si no proporcionas lyrics directamente; describe el género, la instrumentación, el ritmo y el estado de ánimo.
• lyrics (string, opcional): si quieres una pista vocal en lugar de una instrumental, puedes pasar tu propia letra.

No hay campos duration, image_urls ni reference_audio. Si envías campos no admitidos o una carga útil vacía, recibirás un error de validación en lugar de que el parámetro se ignore silenciosamente; vale la pena revisar la respuesta durante la primera integración, porque te dirá de inmediato si el nombre del campo es incorrecto.

En particular sobre la confusión con las "imágenes de producto": si el brief de tu equipo dice "genera imágenes de producto con lyria-3.5", esa instrucción se basa en un modelo equivocado. Para la fotografía de producto real y el material visual publicitario, usa un modelo de imagen: gpt-image-2 es el modelo de texto a imagen más usado de hiapi y destaca en el manejo de imágenes de producto y texto sobre imagen. Combinándolo con lyria-3.5 para la banda sonora de video/anuncios, cubres las dos partes de un video de producto con dos llamadas a la API, sin necesidad de suscribirte a una biblioteca de material.

Consideraciones para producción

• Trata cada generación como un borrador. A 0,09 USD por canción, genera 2–3 variantes por prompt y elige la que mejor se adapte a tu edición, en lugar de intentar perfeccionar un único prompt a la primera.
• Vuelve a alojar antes de publicar. Las URL de salida de temp.hiapi.ai caducan; no las enlaces desde tu tienda en línea o anuncios; descarga y aloja en tu propia CDN.
• Mantén los prompts centrados en el estado de ánimo y la instrumentación. "Upbeat", "warm bass", "no vocals" y las etiquetas de género (electronic-pop, lo-fi, acoustic) guían la salida de forma más fiable que intentar describir una melodía concreta.
• Si necesitas letra o mayor duración, hiapi también ofrece lyria-3-pro (0,14 USD por canción), que puede generar canciones completas de hasta unos tres minutos y admite letras y varios idiomas; vale la pena probarlo cuando pases de una base musical rápida para anuncios a un tema musical de marca.

Preguntas frecuentes

¿Puede lyria-3.5 generar imágenes de producto para un listing de comercio electrónico? No. Lyria 3.5 es un modelo de texto a música y no tiene salida de imagen. Para fotos de producto, usa un modelo de imagen en hiapi, como gpt-image-2.

¿Cuánto cuesta una pista de lyria-3.5? 0,09 USD por cada canción generada, facturado por tarea, independientemente de cómo se use finalmente la pista.

¿Cuánto tarda la generación? En nuestras pruebas, desde el envío de la tarea hasta la pista descargable completa transcurre aproximadamente un minuto.

¿Puedo obtener una voz en lugar de una pieza instrumental? Sí: pasa tu propia lyrics en la solicitud, en lugar de (o junto con) el prompt de estado de ánimo/género.

¿La salida está libre de regalías para anuncios comerciales? La pista se genera específicamente a partir de tu prompt, no es una muestra con licencia; trátala como cualquier material comercial generado por IA de hiapi: puedes usarla en anuncios después de generarla, pero vuelve a alojarla por tu cuenta, porque la URL de entrega caduca.

Enlaces relacionados

• Página del modelo lyria-3.5: precios en vivo, esquema y playgrond de prueba.
• Precios de hiapi: compara lyria-3.5 con todos los demás modelos de audio, imagen y video.
• Documentación de la API de hiapi: referencia completa de /v1/tasks para la generación asíncrona de todos los tipos de modelo.
• API de minimax-music-3: guía de curl y Python: si quieres pistas más largas o con un estilo diferente, este es un segundo modelo de música.

¿Listo para probarlo? Obtén tu clave de API desde tu panel y genera tu primera pista con la solicitud anterior: es una llamada y una prueba de un minuto.