Créer de la musique publicitaire e-commerce avec lyria-3.5 (et non des images de produits)

Lyria 3.5 génère de la musique, pas des photos de produits — voici la bonne façon de l'utiliser pour l'e-commerce

Si vous avez cherché « lyria-3.5 image de produit », la réponse courte est : lyria-3.5 est le modèle de génération de musique à partir de texte de hiapi — il ne peut pas générer de photos de produits. Il n'a pas de sortie image, pas de champ image_urls, et absolument rien de visuel dans son schéma. Son véritable usage est la musique de fond et les bandes sonores, et pour les vendeurs e-commerce, c'est précisément un besoin réel et insuffisamment couvert : chaque vidéo produit, publicité et clip social a besoin d'une bande sonore, et la musique sous licence est plus lente et plus coûteuse que la plupart des équipes ne l'imaginent.

Ce guide présente le scénario réellement viable : utiliser lyria-3.5 pour générer de la musique de fond libre de droits pour les vidéos produits et publicités e-commerce, avec une vraie requête, une vraie réponse et la vraie piste que nous avons générée pour cet article.

Pourquoi ce scénario convient à lyria-3.5

La description officielle du modèle lyria-3.5 par hiapi mentionne explicitement la publicité comme cas d'usage prévu — aux côtés des podcasts et des démos d'indie pop. Ce n'est pas une extrapolation de notre part, c'est le positionnement de la plateforme elle-même. La musique publicitaire e-commerce entre parfaitement dans cette catégorie :

• Les vidéos de démonstration produit (style Shopify/TikTok Shop) ont besoin d'un fond instrumental de 15 à 40 secondes qui ne rivalise pas avec la voix off.
• Les publicités sociales payantes ont besoin d'une ambiance « entraînante et énergique » pour transmettre une promotion ou un lancement, tout en évitant les tracas de licence.
• Les playlists de fond en boutique (vente en direct, vidéos in-app) ont besoin de variété sans payer de frais de synchronisation pour chaque piste.

Lyria 3.5 génère une pièce instrumentale complète à partir d'un prompt texte en environ une minute (ou un morceau vocal si vous fournissez des paroles), pour 0,09 $ par chanson — assez bon marché pour générer plusieurs variantes par campagne et choisir la meilleure, ce qui est exactement la bonne façon d'utiliser un modèle de musique générative : comme première ébauche, pas comme matériel final définitif.

Une génération réelle : prompt, requête, réponse

Voici le prompt exact que nous avons utilisé et la piste exacte qu'il a produite — sans montage, ni sélection dans un lot.

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

Requête (API unifiée de tâches asynchrones 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"
    }
  }'

Cela renvoie immédiatement un ID de tâche ; la génération musicale s'exécute de manière asynchrone, comme pour les modèles d'image et de vidéo de hiapi.

Interrogation jusqu'à l'état final :

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

Réponse une fois terminée (condensée) :

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

Écoutez le résultat réel ici : Bright Shelf — sortie lyria-3.5 (.m4a). Ce lien est une URL de sortie temporaire, qui expire environ 7 jours après la génération — si vous voulez conserver le fichier, téléchargez-le et réhébergez-le vous-même. C'est la procédure standard pour toutes les sorties de tâches hiapi, y compris l'audio : récupérez les octets dès que la tâche est terminée et stockez-les dans votre propre bucket.

Le modèle a lui-même nommé la piste « Bright Shelf » — lyria-3.5 génère automatiquement un titre court à côté de l'audio, ce qui est un détail appréciable si vous constituez une bibliothèque musicale pour une campagne.

Équivalent 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)

Schéma : ce que lyria-3.5 accepte réellement

Le schéma est volontairement étroit — c'est un modèle de génération de musique à partir de texte, pas une boîte à outils audio générale :

• prompt (string) — obligatoire si vous ne fournissez pas directement lyrics ; décrivez le genre, l'instrumentation, le rythme, l'ambiance.
• lyrics (string, optionnel) — si vous voulez un morceau vocal plutôt qu'instrumental, vous pouvez fournir vos propres paroles.

Il n'y a pas de champ duration, image_urls ou reference_audio. Si vous envoyez un champ non pris en charge ou une charge utile vide, vous recevrez une erreur de validation plutôt qu'un paramètre silencieusement ignoré — cela vaut la peine de vérifier la réponse lors de la première intégration, car elle vous indique immédiatement si un nom de champ est incorrect.

Précision sur la confusion autour des « images de produits » : si le brief de votre équipe dit « générer des images de produits avec lyria-3.5 », cette instruction repose sur un mauvais modèle. Pour la photographie de produits et les visuels publicitaires réels, utilisez un modèle d'image — gpt-image-2 est le modèle de génération d'images à partir de texte le plus utilisé de hiapi, et il excelle pour les visuels produits et le texte sur image. Combinez-le avec lyria-3.5 pour la bande sonore vidéo/publicitaire, et vous couvrez les deux parties d'une vidéo produit en deux appels API, sans abonnement à une banque d'images.

Considérations de production

• Considérez chaque génération comme une ébauche. À 0,09 $ par chanson, générez 2 à 3 variantes par prompt, puis choisissez celle qui convient le mieux à votre montage, plutôt que de tenter de peaufiner un seul prompt dès le premier essai.
• Réhébergez avant publication. Les URL de sortie temp.hiapi.ai expirent — ne les liez pas depuis votre boutique en ligne ou vos publicités ; téléchargez et hébergez sur votre propre CDN.
• Gardez le prompt centré sur l'ambiance et l'instrumentation. « Upbeat », « warm bass », « no vocals » et les étiquettes de genre (electronic-pop, lo-fi, acoustic) orientent la sortie de manière plus fiable que la tentative de décrire une mélodie précise.
• Si vous avez besoin de paroles ou de durées plus longues, hiapi propose aussi lyria-3-pro (0,14 $ par chanson), capable de générer des chansons complètes allant jusqu'à environ trois minutes, avec prise en charge des paroles et du multilinguisme — cela vaut la peine d'essayer lorsque vous passez d'un fond publicitaire rapide à une musique de thème de marque.

Questions fréquentes

lyria-3.5 peut-il générer des images de produits pour une fiche e-commerce ? Non. Lyria 3.5 est un modèle de génération de musique à partir de texte, sans sortie image. Pour les photos de produits, utilisez un modèle d'image sur hiapi, comme gpt-image-2.

Combien coûte une piste lyria-3.5 ? 0,09 $ par chanson générée, facturé par tâche, quel que soit l'usage final de la piste.

Combien de temps prend la génération ? Dans nos tests, il faut environ une minute entre la soumission de la tâche et l'obtention d'une piste téléchargeable.

Puis-je obtenir des voix plutôt qu'un instrumental ? Oui — fournissez vos propres lyrics dans la requête, à la place (ou en complément) du prompt d'ambiance/genre.

La sortie est-elle libre de droits pour une publicité commerciale ? La piste est générée spécifiquement pour votre prompt, pas à partir d'échantillons sous licence — traitez-la comme tout autre contenu commercial généré par IA provenant de hiapi : vous pouvez l'utiliser dans vos publicités après génération, mais réhébergez-la vous-même, car l'URL de livraison expire.

Liens associés

• Page du modèle lyria-3.5 — tarification en temps réel, schéma et playground d'essai.
• Tarification hiapi — comparez lyria-3.5 avec tous les autres modèles audio, image et vidéo.
• Documentation API hiapi — référence complète de /v1/tasks pour la génération asynchrone sur tous les types de modèles.
• API minimax-music-3 : guide curl et Python — un second modèle musical si vous voulez des pistes plus longues ou d'un style différent.

Prêt à essayer ? Récupérez votre clé API depuis votre tableau de bord et générez votre première piste avec la requête ci-dessus — c'est un test d'un appel et d'une minute.