Lyria 3 Clip Preview

Lyria 3 Clip Preview é o modelo musical da Google para excertos curtos, loops e amostras prévias. Recebe inspiração de texto ou imagem e produz música de 30 segundos com áudio estéreo de 48 kHz, suportando vozes, letras com marcações temporais e arranjos instrumentais.

Ailoot · Música POST /v1/music/generations google/lyria-3-clip-preview

Sobre o modelo

Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.

Lyria 3 Clip Preview é o perfil de geração musical da Google para excertos curtos, loops e amostras prévias. Aceita um prompt textual ou inspiração de imagem e devolve texto e áudio. O perfil publicado descreve excertos de 30 segundos com áudio estéreo de 48 kHz, incluindo vozes, letras com marcações temporais e arranjos instrumentais completos.

Descreva o momento musical

Indique o propósito do excerto e o ambiente que deve transmitir. Um tema curto de abertura pode especificar uma introdução contida e um ponto de chegada claro; uma passagem de fundo pode identificar o ritmo e a textura necessários sob uma cena visual. Declare se o resultado deve incluir vozes ou ser instrumental e indique os elementos musicais que importam para o briefing.

Mantenha a estrutura suficientemente pequena para o excerto. Identifique a abertura, a frase principal e o final ou ponto de loop. Se as palavras importam, forneça a ideia lírica ou a formulação pretendida e examine o resultado efetivamente cantado. O briefing musical deve distinguir o conteúdo vocal das orientações sobre o arranjo.

Inspiração de imagem e arranjo

Ao fornecer uma imagem, explique que cena ou ambiente contribui para o pedido musical. Uma paisagem calma e uma cena noturna cheia de pessoas sugerem direções diferentes, mas o papel emocional pretendido deve continuar explícito no texto. Mantenha a imagem com o prompt ao comparar o excerto devolvido com o conceito pretendido.

Reveja o equilíbrio entre vozes, instrumentos e a frase musical principal. Para um loop, ouça o fim e o início em conjunto; para uma amostra prévia, verifique se a curta duração comunica a direção pretendida. Um excerto que acompanha uma montagem deve ser revisto em relação a essa montagem, em vez de apenas isoladamente.

Conserve o resultado de áudio

Guarde o áudio real e qualquer texto que o acompanhe com o briefing. Examine as propriedades do ficheiro ao preparar reprodução ou importação para um editor e preserve qualquer informação de letra ou tempos devolvida pelo pedido. A música é a saída do modelo; cortes, títulos, transições visuais e uma mistura final de produção podem ser organizados em torno desse recurso examinado.

Este perfil Clip Preview exato adequa-se a um entregável musical compacto. Mantenha o seu papel de formato curto distinto ao planear uma composição mais longa e escolha o excerto devolvido ouvindo a frase completa, as palavras cantadas e o final.

Ailoot · Música POST /v1/music/generations google/lyria-3-clip-preview

google/lyria-3-clip-preview

Google /google/lyria-3-clip-preview

Introdução

Entradas aceites: Texto
Resultados: music

Disponível no Ailoot · entradas e métodos

Ailoot · Música POST /v1/music/generations

Entrada: text
Saída: music
Formato de saída: excertos completos de áudio pertencentes ao utilizador / ligações JSON

Campo	Tipo	Requisito	Valores e limites	Predefinição
Campo`model`	Tipo`string`	RequisitoObrigatório	Valores e limites google/lyria-3-clip-preview	Predefinição—
Campo`prompt`	Tipo`string`	RequisitoObrigatório	Valores e limites Comprimento mínimo: 1	Predefinição—

Combinações de materiais de entrada

text_to_music · Obrigatório: prompt

Parâmetros e ciclo de vida do método

Parâmetro	Contrato
Parâmetro`material_types`	Contratotext
Parâmetro`required`	Contratonull
Parâmetro`optional_controls`	Contratonull

Ciclo de vida: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id efetivamente devolvido ou registo na biblioteca de multimédia

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

As estruturas dos métodos e os ID são exatos; a capacidade do fornecedor é distinta da admissão dos pedidos.

Tarifários

Tarifas dos métodos Ailoot

Ailoot MúsicaPOST /v1/music/generations

Saída: 0,04 US$ por clip
Apenas referência · não somada: 0,04 US$ por pedido

Clipes entregues × tarifa base por clipe. A referência por pedido não é somada. Exemplos antes dos ajustes aplicáveis.

1 × 0,04 US$ = 0,04 US$

O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →

Detalhes da tarifa de referência

As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.

Tabelas de referência do modelo

Preços por configuração

Configuração	Escalão de serviço	Condição de contexto	Custo
ConfiguraçãoUltra	Escalão de serviçostandard	Condição de contexto{}	Custo Saída · música 0,08 US$ por canção

Exemplos de pedidos

Ailoot · Música

Exemplo de música

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
export AILOOT_API_KEY
python3 - <<'PY_RESULT'
import json, os, subprocess
from pathlib import Path
from urllib.parse import urljoin, urlparse
result=json.loads(Path("result.json").read_text(encoding="utf-8"))
print(json.dumps(result,ensure_ascii=False,indent=2))
for number,clip in enumerate(result.get("data") or []):
    u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))
    if u.scheme!="https" or not u.hostname or u.username or u.password:
        raise SystemExit("Result URL must be HTTPS without embedded credentials")
    owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")
    args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]
    if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
    raw=subprocess.check_output(args)
    ext="wav" if raw.startswith(b"RIFF") and raw[8:12]==b"WAVE" else "flac" if raw.startswith(b"fLaC") else "ogg" if raw.startswith(b"OggS") else "mp3" if raw.startswith(b"ID3") or raw[:1]==b"\xff" else "bin"
    f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)
    print("Saved",f,clip.get("asset_id"))

PY_RESULT

Receber e guardar os resultados

Ailoot · Música

excertos completos de áudio pertencentes ao utilizador / ligações JSON

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Guardar todos os resultados concluídos

Guarde cada resposta, ficheiro e parte de conteúdo devolvidos na íntegra.

Guarde/obtenha todos os excertos devolvidos e conserve o ID, MIME e metadados reais. O método é síncrono; não introduz um URL separado de consulta periódica da geração de música da Ailoot.

Se for necessário verificar a resposta original

Se um resultado de música precisar de verificação, conserve o operation_id/X-Client-Request-ID original e a informação dos excertos devolvidos. Recupere os excertos existentes que pertencem ao utilizador através da biblioteca multimédia, utilizando os valores reais de task_id ou asset_id. Não volte a enviar o pedido de música nem construa um URL de consulta periódica da geração a partir de operation_id.

Campos da resposta

Campo	Tipo
Campo`model`	Tipostring
Campo`response_id`	Tipostring
Campo`data[]`	Tipoowned clip record

Erros e passos seguintes

Resposta	Condição	Passo seguinte
Resposta400 · `invalid_request_error`	CondiçãoCampos obrigatórios, representação do material ou valor do parâmetro inválidos	Passo seguinteCorrija os campos indicados antes de um novo pedido de criação.
Resposta`server_error`	CondiçãoA resposta devolvida indica que a operação ou o resultado requer verificação	Passo seguinteGuarde o ID original da operação/tarefa devolvido, os cabeçalhos do pedido e a resposta; continue a consultar essa operação original através das consultas suportadas. Não volte a enviar o pedido de criação.

Aliases

Aliases do modelo

Ailoot google/lyria-3-clip-preview

Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

IDs de chamada relacionados

google/lyria-3-clip-preview

FAQ · Lyria 3 Clip Preview

Que entradas e resultados estão disponíveis?: POST /v1/music/generations · google/lyria-3-clip-preview: text → music
Que campos utiliza o pedido?: POST /v1/music/generations · google/lyria-3-clip-preview: model, prompt

Lyria 3 Clip Preview