Criar música para anúncios de e-commerce com lyria-3.5 (em vez de imagens de produto)

O Lyria 3.5 gera música, não fotos de produto — veja a forma correta de usá-lo no e-commerce

Se você pesquisou por "lyria-3.5 imagem de produto", a resposta curta é: lyria-3.5 é o modelo de texto para música da hiapi — ele não consegue gerar fotos de produto. Não tem saída de imagem, não tem campo image_urls, e seu schema não contém absolutamente nada relacionado a visual. Seu uso real é trilha sonora e música de fundo, e para vendedores de e-commerce essa é justamente uma necessidade real e pouco atendida: todo vídeo de produto, anúncio e short social precisa de trilha, e música de banco de licenças é mais lenta e mais cara do que a maioria das equipes espera.

Este guia mostra o cenário que realmente funciona: usar o lyria-3.5 para gerar trilhas sonoras livres de royalties para vídeos de produto e anúncios de e-commerce, com uma requisição real, uma resposta real e a faixa real que geramos para este artigo.

Por que este cenário se encaixa no lyria-3.5

A descrição oficial do modelo lyria-3.5 na hiapi nomeia explicitamente publicidade como caso de uso previsto — ao lado de podcasts e demos de indie pop. Não é uma interpretação forçada nossa, é o próprio posicionamento da plataforma. Música para anúncios de e-commerce se encaixa perfeitamente nessa categoria:

• Vídeos de demonstração de produto (estilo Shopify/TikTok Shop) precisam de 15–40 segundos de base instrumental que não dispute espaço com a narração em voz.
• Anúncios pagos em redes sociais precisam de um clima "alegre e energético" para transmitir promoção ou lançamento, sem complicações de licenciamento.
• Playlists de fundo da loja (live commerce, vídeos no app) precisam de variedade sem pagar taxa de licença de sincronização por faixa.

O Lyria 3.5 gera uma faixa instrumental completa a partir de um prompt de texto em cerca de um minuto (ou uma faixa vocal, se você fornecer a letra), por US$ 0,09 por música — barato o suficiente para gerar várias variantes por campanha e escolher a melhor, que é exatamente a forma correta de usar modelos generativos de música: como rascunho, não como material final definitivo.

Uma geração real: prompt, requisição, resposta

Abaixo está o prompt exato que usamos e a faixa exata que ele gerou — sem edição e sem seleção a partir de um 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

Requisição (API unificada de tarefas assíncronas da 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"
    }
  }'

Isso retorna imediatamente um ID de tarefa; a geração de música roda de forma assíncrona, igual aos modelos de imagem e vídeo da hiapi.

Polling até o estado final:

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

Resposta após conclusão (resumida):

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

Ouça o resultado real aqui: Bright Shelf — saída do lyria-3.5 (.m4a). Este link é uma URL de saída temporária e expira cerca de 7 dias após a geração — se quiser manter o arquivo, baixe e hospede novamente por conta própria. Esse é o padrão para todas as saídas de tarefas da hiapi, incluindo áudio: assim que a tarefa concluir, obtenha os bytes e armazene no seu próprio bucket.

O modelo nomeou a faixa como "Bright Shelf" por conta própria — o lyria-3.5 gera automaticamente um título curto junto com o áudio, um detalhe útil se você estiver organizando uma biblioteca de músicas para uma campanha.

Código equivalente em 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)

Schema: o que o lyria-3.5 realmente aceita

O schema é deliberadamente estreito — é um modelo de texto para música, não um kit de ferramentas de áudio genérico:

• prompt (string) — obrigatório se você não fornecer lyrics diretamente; descreve gênero, instrumentação, ritmo, clima.
• lyrics (string, opcional) — se quiser uma faixa vocal em vez de instrumental, passe sua própria letra.

Não há campos duration, image_urls ou reference_audio. Se você enviar um campo não suportado ou um payload vazio, receberá um erro de validação, e não um parâmetro silenciosamente ignorado — vale a pena verificar a resposta na primeira integração, pois ela informa imediatamente se o nome do campo está errado.

Especificamente sobre a confusão com "imagem de produto": se o briefing da sua equipe disser "gerar imagens de produto com lyria-3.5", essa instrução se baseia em um modelo errado. Para fotografia de produto real e material visual de anúncios, use um modelo de imagem — gpt-image-2 é o modelo de texto para imagem mais usado da hiapi, com bom desempenho em imagens de produto e texto na imagem. Combine-o com o lyria-3.5 para a trilha de vídeo/anúncio e você cobre as duas partes de um vídeo de produto com duas chamadas de API, sem assinar banco de imagens.

Considerações para produção

• Trate cada geração como rascunho. A US$ 0,09 por música, gere 2–3 variantes por prompt e escolha a que melhor se encaixa na sua edição, em vez de tentar aperfeiçoar um único prompt de primeira.
• Rehospede antes de publicar. As URLs de saída de temp.hiapi.ai expiram — não linke a partir da loja online ou do anúncio; baixe e hospede no seu próprio CDN.
• Mantenha o prompt focado em clima e instrumentação. "Upbeat", "warm bass", "no vocals" e tags de gênero (electronic-pop, lo-fi, acoustic) guiam a saída de forma mais confiável do que tentar descrever uma melodia específica.
• Se você precisa de letra ou duração maior, a hiapi também oferece o lyria-3-pro (US$ 0,14 por música), que gera músicas completas de até cerca de três minutos, com suporte a letras e multilíngue — vale a pena quando você avança de trilhas rápidas para anúncios para música-tema de marca.

Perguntas frequentes

O lyria-3.5 consegue gerar imagens de produto para listagens de e-commerce? Não. O Lyria 3.5 é um modelo de texto para música e não tem saída de imagem. Para fotos de produto, use um modelo de imagem na hiapi, como gpt-image-2.

Quanto custa uma faixa do lyria-3.5? US$ 0,09 por música gerada, cobrado por tarefa, independentemente de como a faixa seja usada no final.

Quanto tempo leva para gerar? Nos nossos testes, cerca de um minuto desde o envio da tarefa até a faixa concluída e disponível para download.

Posso obter vocais em vez de instrumental? Sim — passe seu próprio lyrics na requisição, no lugar (ou junto) do prompt de clima/gênero.

A saída é livre de royalties para anúncios comerciais? A faixa é gerada especificamente para o seu prompt, não é uma amostra licenciada — trate-a como qualquer material comercial gerado por IA da hiapi: após a geração você pode usá-la em anúncios, mas rehospede-a por conta própria, pois a URL de entrega expira.

Links relacionados

• Página do modelo lyria-3.5 — preços em tempo real, schema e playground de testes.
• Preços da hiapi — compare o lyria-3.5 com todos os outros modelos de áudio, imagem e vídeo.
• Documentação da API hiapi — referência completa de /v1/tasks para geração assíncrona em todos os tipos de modelo.
• API minimax-music-3: guia com curl e Python — um segundo modelo de música, caso você queira faixas mais longas ou de estilo diferente.

Pronto para experimentar? Obtenha uma chave de API no seu painel e gere sua primeira faixa com a requisição acima — é um teste de uma chamada e um minuto.