Source: https://ailoot.ai/models/pt-pt/google-lyria/
Canonical: https://ailoot.ai/models/pt-pt/google-lyria/
Language: pt-pt

# Lyria

[Markdown](https://ailoot.ai/models/pt-pt/google-lyria/index.md) · [JSON](https://ailoot.ai/models/pt-pt/google-lyria/facts.json)

## [Lyria](https://ailoot.ai/models/pt-pt/google-lyria/)

Geração musical por texto, com 1 a 8 excertos pedidos e entrega síncrona do resultado.

- [**Ailoot · Música** `POST /v1/music/generations` `google/lyria`](https://ailoot.ai/models/pt-pt/google-lyria/#method-0)

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.

google/lyria cria música a partir de texto em /v1/music/generations. Pode pedir um fundo instrumental discreto para demonstração de produto, descrevendo instrumentos principais e espaço necessário à narração. Escolha esta rota quando o resultado pretendido for um excerto musical gerado.

O pedido exige model e prompt. n ou count aceita 1 a 8 excertos e o método devolve o resultado sincronamente. Guarde todos os excertos e metadados reais. Não expõe referência áudio, duração ou andamento como controlos independentes. Descreva a intenção musical no prompt sem a tratar como propriedade medida garantida da saída.

**Ailoot · Música** `POST /v1/music/generations` `google/lyria`

[`google/lyria`](https://ailoot.ai/models/pt-pt/#m=google%2Flyria&route=Core&caller=google%2Flyria&fmt=music)

Google /`google/lyria`

### Introdução

Geração musical por texto, com 1 a 8 excertos pedidos e entrega síncrona do resultado.

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 | Predefinição— |
| Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites Comprimento mínimo: 1 | Predefinição— |
| Campo`n` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 8 | Predefinição1 |
| Campo`count` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 8 Condições: Se n também for fornecido, a contagem tem de coincidir | 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

Saída

0,08 US$ *por clip*

Apenas referência · não somada

0,08 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,08 US$ = 0,08 US$`

`4 × 0,08 US$ = 0,32 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 →](https://ailoot.ai/docs/pt-pt/billing/reserve/)

### Exemplos de pedidos

#### Ailoot · Música

Exemplo de música

```bash
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", "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`](https://ailoot.ai/models/pt-pt/#m=google%2Flyria&route=Core&caller=google%2Flyria&fmt=music)

#### Aliases dos caminhos dos métodos

Use os caminhos dos métodos indicados acima.

#### IDs de chamada relacionados

[`google/lyria`](https://ailoot.ai/models/pt-pt/#m=google%2Flyria&route=Core&caller=google%2Flyria&fmt=music)

FAQ · Lyria

Que entradas e resultados estão disponíveis?

`POST /v1/music/generations` · `google/lyria`: `text` → `music`

Que campos utiliza o pedido?

`POST /v1/music/generations` · `google/lyria`: `model`, `prompt`, `n`, `count`

Que limites se aplicam?

`POST /v1/music/generations` · `google/lyria`: `n.minimum`: `1`; `n.maximum`: `8`; `count.minimum`: `1`; `count.maximum`: `8`

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

## A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

## Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição

Escolha um plano com desconto para os pedidos regulares.

Código promocional até 50%

Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.

Custos no histórico

O modelo, os tokens e o montante são guardados para cada pedido.

[Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/)

## Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial

Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.

Licença de revendedor

Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.

Documentos no site

A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

[Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt)

## Ailoot · A empresa e a sua carteira de projetos





A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.





A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.





A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.