Creare musica per annunci e-commerce con lyria-3.5 (non immagini di prodotto)

Lyria 3.5 genera musica, non foto di prodotto — ecco il modo corretto di usarlo per l'e-commerce

Se hai cercato "lyria-3.5 immagini di prodotto", la risposta breve è: lyria-3.5 è il modello di generazione musicale da testo di hiapi — non può generare foto di prodotto. Non ha output di immagini, non ha un campo image_urls, e nel suo schema non c'è assolutamente nulla di visivo. Il suo vero utilizzo è la musica di sottofondo e le colonne sonore, e per i venditori e-commerce questo è esattamente un bisogno reale e poco soddisfatto: ogni video di prodotto, annuncio e clip social ha bisogno di una colonna sonora, e la musica royalty-free è più lenta e costosa di quanto la maggior parte dei team si aspetti.

Questa guida mostra lo scenario realmente fattibile: usare lyria-3.5 per generare musica di sottofondo royalty-free per video di prodotto e annunci e-commerce, con una richiesta reale, una risposta reale e la traccia reale che abbiamo generato per questo articolo.

Perché questo scenario si adatta a lyria-3.5

La descrizione ufficiale del modello lyria-3.5 di hiapi cita esplicitamente la pubblicità come caso d'uso previsto — insieme a podcast e demo di indie pop. Non è una nostra forzatura, è il posizionamento della piattaforma stessa. La musica per annunci e-commerce rientra perfettamente in questa categoria:

• Video dimostrativi di prodotto (stile Shopify/TikTok Shop) hanno bisogno di un tappeto strumentale di 15–40 secondi che non competa con la voce narrante.
• Annunci social a pagamento hanno bisogno di un'atmosfera "allegra, energica" per comunicare una promozione o un lancio, evitando complicazioni di licenza.
• Playlist di sottofondo del negozio (live commerce, video in-app) hanno bisogno di varietà senza dover pagare una licenza di sincronizzazione per ogni traccia.

Lyria 3.5 può generare un brano strumentale completo da un prompt testuale in circa un minuto (o un brano vocale se fornisci i testi) a 0,09 dollari per brano — abbastanza economico da generare diverse varianti per ogni campagna e scegliere la migliore, che è esattamente il modo giusto di usare un modello di musica generativa: come bozza, non come materiale finale in un solo colpo.

Una generazione reale: prompt, richiesta, risposta

Ecco il prompt esatto che abbiamo usato e la traccia esatta che ha generato — senza modifiche e senza selezione da un lotto.

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

Richiesta (API asincrona unificata di 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"
    }
  }'

Questo restituisce immediatamente un ID attività; la generazione musicale viene eseguita in modo asincrono, come per i modelli di immagini e video di hiapi.

Polling fino allo stato finale:

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

Risposta al completamento (abbreviata):

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

Ascolta il risultato effettivo qui: Bright Shelf — output di lyria-3.5 (.m4a). Questo link è un URL di output temporaneo, che scade circa 7 giorni dopo la generazione — se vuoi conservare il file, scaricalo e riospitalo tu stesso. Questo è lo standard per tutti gli output delle attività di hiapi, inclusi quelli audio: recupera i byte immediatamente dopo il completamento dell'attività e salvali nel tuo bucket.

Il modello ha assegnato autonomamente alla traccia il titolo "Bright Shelf" — lyria-3.5 genera automaticamente un breve titolo accanto all'audio, un bel dettaglio se stai organizzando una libreria musicale per una campagna.

Codice Python equivalente

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)

Schema: cosa accetta effettivamente lyria-3.5

Lo schema è volutamente molto ristretto — è un modello di generazione musicale da testo, non un toolkit audio generico:

• prompt (string) — obbligatorio se non fornisci direttamente lyrics; descrive genere, strumentazione, ritmo, atmosfera.
• lyrics (string, opzionale) — se vuoi un brano vocale invece che strumentale, puoi passare i tuoi testi.

Non ci sono campi duration, image_urls o reference_audio. Se invii campi non supportati o un payload vuoto, ricevi un errore di validazione anziché parametri ignorati silenziosamente — vale la pena controllare la risposta durante la prima integrazione, perché ti dice subito se il nome di un campo è sbagliato.

In particolare sull'equivoco delle "immagini di prodotto": se il brief del tuo team dice "genera immagini di prodotto con lyria-3.5", quell'istruzione si basa su un modello sbagliato. Per la fotografia di prodotto e i materiali visivi pubblicitari reali, usa un modello di immagini — gpt-image-2 è il modello di generazione di immagini da testo più usato di hiapi, abile con immagini di prodotto e testo nelle immagini. Abbinalo a lyria-3.5 per la colonna sonora di video/annunci e coprirai entrambe le parti di un video di prodotto con due chiamate API, senza abbonarti a una libreria di materiali.

Note per la produzione

• Considera ogni generazione una bozza.A 0,09 dollari per brano, genera 2–3 varianti per ogni prompt, poi scegli quella che si adatta meglio al tuo montaggio, invece di cercare di perfezionare un singolo prompt al primo tentativo.
• Riospita prima di pubblicare.Gli URL di output temp.hiapi.ai scadono — non collegarli dal tuo negozio online o dagli annunci; scarica e ospita sul tuo CDN.
• Mantieni il prompt concentrato su atmosfera e strumentazione."Upbeat", "warm bass", "no vocals" e le etichette di genere (electronic-pop, lo-fi, acoustic) guidano l'output in modo più affidabile che cercare di descrivere una melodia specifica.
• Se ti servono testi o una durata maggiore, hiapi offre anche lyria-3-pro (0,14 dollari per brano), che genera canzoni complete fino a circa tre minuti e supporta testi e più lingue — vale la pena provarlo quando passi dal tappeto musicale rapido per annunci a un tema musicale di brand.

Domande frequenti

lyria-3.5 può generare immagini di prodotto per le inserzioni e-commerce? No. Lyria 3.5 è un modello di generazione musicale da testo, senza output di immagini. Per le foto di prodotto, usa un modello di immagini su hiapi, come gpt-image-2.

Quanto costa una traccia lyria-3.5? 0,09 dollari per brano generato, con fatturazione per attività, indipendentemente da come verrà usata la traccia.

Quanto tempo richiede la generazione? Nei nostri test, dall'invio dell'attività alla disponibilità della traccia scaricabile passano circa un minuto.

Posso ottenere una voce invece che uno strumentale? Sì — passa i tuoi lyrics nella richiesta, al posto (o insieme) al prompt di atmosfera/genere.

L'output è royalty-free per gli annunci commerciali? Le tracce sono generate specificamente per il tuo prompt, non sono campioni con licenza — trattale come qualsiasi materiale commerciale generato dall'AI su hiapi: dopo la generazione puoi usarle nei tuoi annunci, ma riospitale tu stesso, perché gli URL di consegna scadono.

Link correlati

• Pagina del modello lyria-3.5 — prezzi in tempo reale, schema e playground di prova.
• Prezzi hiapi — confronta lyria-3.5 con tutti gli altri modelli audio, di immagini e video.
• Documentazione API hiapi — riferimento completo a /v1/tasks per la generazione asincrona di tutti i tipi di modello.
• API minimax-music-3: guida curl e Python — un secondo modello musicale se vuoi tracce più lunghe o di stile diverso.

Pronto a provarlo? Ottieni una chiave API dalla tua dashboard e genera la tua prima traccia con la richiesta qui sopra — è un test da una chiamata e un minuto.