Google

Lyria 3.5

lyria-3.5

Modelo emblemático de geração musical do Google: primeiro planeja a estrutura (introdução, verso, refrão etc.) e depois gera uma música completa com vocais e letras, com suporte a canto em vários idiomas e acesso por meio da interface unificada do HiAPI.ai

lyria-3.5

Experimentar lyria-3.5

Entrada

Lyrics

Criações

Ver todas as criações

Saída

audio

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

lyria-3.5 per song

Preço unitário	$0.090

Visão geral

Lyria 3.5 é um modelo voltado para a geração de música a partir de texto, que pode ser chamado por meio da interface unificada do HiAPI.ai. Ele pode tanto gerar uma faixa completa a partir de uma descrição musical (gênero, instrumentos, humor, estrutura) quanto receber diretamente uma letra com marcações de seção como [Verse] e [Chorus] para ser cantada, permitindo especificar duração, BPM, título e seed aleatória. O resultado é uma canção completa com vocais, ideal para desenvolvedores que precisam obter rapidamente um produto final bem estruturado, para trilhas de conteúdo, músicas em vários idiomas e validação de demos criativas.

Destaques principais

Organiza a música inteira por seções, em vez de colar fragmentos — antes de gerar, planeja intro, verso, refrão, ponte e demais estruturas, resultando em um produto com seções claras e coeso do início ao fim.
Basta uma descrição ou uma letra para criar a música — com apenas a descrição musical é possível produzir uma faixa instrumental ou com vocais; com apenas a letra, o processo entra direto na geração do canto.
Duração e andamento podem ser restringidos na requisição — é possível especificar uma duração alvo de 1 a 240 segundos e um BPM numérico, facilitando reservar o comprimento conforme o ponto de veiculação.

Descrição das capacidades

Geração de faixa completa a partir de descrição textual: com uma descrição de até 10000 caracteres informando gênero, instrumentos, humor e estrutura, obtém-se diretamente uma faixa completa, reduzindo etapas de arranjo e edição manuais.

Canto guiado por letra: basta enviar uma letra com marcações de seção para gerar uma canção com vocais, podendo preencher o título e produzir uma demo de letra e música pronta para audição.

Duração e andamento controláveis: é possível solicitar uma duração alvo de 1 a 240 segundos e especificar o BPM; a duração real da saída pode divergir do valor solicitado, portanto o projeto deve considerar uma faixa, não um valor exato.

Seed aleatória e tentativas reproduzíveis: é possível passar uma seed numérica para organizar várias rodadas de geração, mas as mesmas configurações não garantem áudio idêntico na saída, sendo adequado para exploração de variantes e não para reprodução determinística.

Saída apenas de áudio: retorna o arquivo de áudio final, que pode entrar diretamente na biblioteca de materiais ou em fluxos posteriores de distribuição, sem necessidade de conversão de formato.

Cenários de aplicação

Trilhas para vídeos curtos e podcasts de criadores de conteúdo — insira uma descrição musical de atmosfera e ritmo para obter uma trilha de fundo compatível com a duração do vídeo final, pronta para uso na linha do tempo de edição.
Demos de audição de letras para criadores musicais — envie uma letra com marcações [Verse] e [Chorus] para produzir uma versão cantada audível, usada para validar ideias de letra e música e comparar versões.
Trilhas personalizadas para publicidade e conteúdo de marca — gere faixas originais alinhadas ao tom visual a partir de descrições de gênero, instrumentos e humor, como base de trilha para materiais de veiculação.
Protótipos de trilha para jogos e mídias interativas — use descrições com restrições de BPM e duração para gerar em lote trechos de atmosfera, como protótipos iniciais de música de fases ou interfaces para avaliação da equipe.

Limitações e recomendações de escolha

Suporta apenas entrada de texto e letra, não aceitando orientação por imagem; a saída é um arquivo de áudio com marca d'água e os resultados gerados não podem ser armazenados em cache. A duração de cada faixa vai de segundos a alguns minutos, não sendo adequado para situações que exigem trilhas longas e contínuas ou entrega sem perdas de alta fidelidade. A duração real da saída e os detalhes do áudio não são garantidos como totalmente iguais aos parâmetros solicitados, e a mesma seed também não reproduz o mesmo resultado. Se for necessário edição de áudio precisamente controlável, separação de faixas ou reprodução determinística, outras soluções devem ser avaliadas; este modelo é mais adequado para produzir rapidamente canções completas e bem estruturadas.

Novidades

Ver o changelog →

Novo modelo Nova documentação da API lyria-3.5 Sep 11, 2026

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: lyria-3.5

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para lyria-3.5 e a rota default — veja a tabela de parâmetros abaixo.

bpmstringOpcionalpattern ^[1-9][0-9]*(\.[0-9]+)?$

Opcional, especifica o tempo (BPM) da faixa gerada, passado como uma string numérica, com valor mínimo de 1.

seedstringOpcionalminLength 1pattern ^[0-9]+$

Opcional, semente aleatória, passada como uma string numérica; as mesmas configurações não garantem a geração de um áudio exatamente igual.

titlestringOpcional

Opcional, especifica um título para a música gerada.

lengthintegerOpcionalmin 1max 240

Opcional, a duração solicitada do áudio (em segundos), com valores de 1 a 240; a duração real da saída pode ser diferente.

lyricsstringOpcionalminLength 1pattern \S

Opcional, o conteúdo da letra, podendo usar tags de seção como [Verse], [Chorus]; é necessário fornecer ao menos um entre a letra e a descrição musical.

promptstringOpcionalminLength 1maxLength 10000pattern \S

Opcional, descrição musical, usada para indicar estilo, instrumentos, clima e estrutura; é necessário fornecer ao menos um entre a descrição musical e a letra.

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -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": {}
}'

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.5",
    input: {}
  }),
});
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.5",
        "input": {}
    },
)
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"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "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
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "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"
    }
  }
}