Lyria 3 Clip Preview
Lyria 3 Clip Preview es el modelo musical de Google para clips cortos, bucles y muestras previas. Recibe inspiración textual o visual y produce música de 30 segundos con audio estéreo de 48 kHz, con compatibilidad para voces, letras con tiempos y arreglos instrumentales.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Lyria 3 Clip Preview es el perfil de generación musical de Google para clips cortos, bucles y muestras previas. Acepta un prompt de texto o inspiración visual y devuelve texto y audio. El perfil publicado describe clips de 30 segundos con audio estéreo de 48 kHz, incluidas voces, letras con tiempos y arreglos instrumentales completos.
Describe el momento musical
Indica el propósito del clip y el ambiente que debe transmitir. Un tema corto de apertura puede especificar una introducción contenida y una entrada clara al tema principal; una pieza de fondo puede identificar el ritmo y la textura necesarios bajo una escena visual. Indica si el resultado debe incluir voces o ser instrumental y nombra los elementos musicales que importen para las instrucciones.
Mantén la estructura lo bastante pequeña para el clip. Identifica la apertura, la frase principal y el final o punto de bucle. Si importan las palabras, proporciona la idea lírica o formulación prevista y examina el resultado realmente cantado. Las instrucciones musicales deben distinguir el contenido vocal de las indicaciones sobre el arreglo.
Inspiración visual y arreglo
Al proporcionar una imagen, explica qué escena o ambiente aporta a la solicitud musical. Un paisaje tranquilo y una escena nocturna concurrida sugieren direcciones diferentes, pero la función emocional deseada debe seguir explícita en el texto. Conserva la imagen junto con el prompt al comparar el clip devuelto con el concepto previsto.
Revisa el equilibrio entre voces, instrumentos y la frase musical principal. Para un bucle, escucha juntos el final y el principio; para una muestra previa, comprueba si la duración corta comunica la dirección prevista. Un clip que acompañe un montaje debe revisarse frente a ese montaje, en lugar de únicamente de forma aislada.
Conserva el resultado de audio
Guarda el audio real y cualquier texto que lo acompañe junto con las instrucciones. Examina sus propiedades de archivo al preparar la reproducción o importarlo en un editor y conserva cualquier información de letra o tiempos devuelta por la solicitud. La música es la salida del modelo; los cortes, títulos, transiciones visuales y una mezcla final de producción pueden organizarse alrededor de ese recurso examinado.
Este perfil exacto Clip Preview es adecuado para un entregable musical compacto. Mantén diferenciada su función de formato corto al planificar una composición más larga y elige el clip devuelto escuchando la frase completa, las palabras cantadas y el final.
Ailoot · Música POST /v1/music/generations google/lyria-3-clip-preview
google/lyria-3-clip-previewInicio
Lyria 3 Clip Preview es el modelo musical de Google para clips cortos, bucles y muestras previas. Recibe inspiración textual o visual y produce música de 30 segundos con audio estéreo de 48 kHz, con compatibilidad para voces, letras con tiempos y arreglos instrumentales.
- Entradas aceptadas
- Texto
- Resultados
- music
Disponible en Ailoot · entradas y métodos
Ailoot · Música POST /v1/music/generations
- Entrada
text- Salida
music- Formato de salida
- clips de audio completos que te pertenecen / enlaces JSON
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites google/lyria-3-clip-preview | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Combinaciones de materiales de entrada
text_to_music · Obligatorio: prompt
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetromaterial_types | Contratotext |
Parámetrorequired | Contratonull |
Parámetrooptional_controls | Contratonull |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · El task_id real devuelto o el registro de la biblioteca multimedia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Las estructuras e ID de los métodos son exactos; la capacidad del proveedor y la admisión son conceptos distintos.
Tarifas
Tarifas de métodos Ailoot
POST /v1/music/generations- Salida
- USD 0.04 por clip
- Solo referencia · no se suma
- USD 0.04 por solicitud
Clips entregados × tarifa base por clip. La referencia por solicitud no se suma. Ejemplos antes de los ajustes aplicables.
1 × USD 0.04 = USD 0.04
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Detalles de la tarifa de referencia
Las tablas de referencia del modelo no cambian la selección del método, las cotizaciones ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
Tablas de referencia del modelo
Precios por configuración
| Configuración | Nivel de servicio | Condición de contexto | Cargo |
|---|---|---|---|
| ConfiguraciónUltra | Nivel de serviciostandard | Condición de contexto{} | Cargo Salida · música USD 0.08 por canción |
Solicitudes de ejemplo
Ailoot · 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
Recibir y guardar resultados
Ailoot · Música
clips de audio completos que te pertenecen / enlaces JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Guarda o recupera cada clip devuelto y conserva su ID, MIME y metadatos reales. El método es síncrono; no se incorpora una URL de consulta independiente de Ailoot para la generación de música.
Si es necesario revisar la respuesta original
Si un resultado de música requiere verificación, conserva el operation_id/X-Client-Request-ID original y la información de los clips devueltos. Recupera los clips existentes que te pertenezcan desde la biblioteca multimedia usando valores reales de task_id o asset_id. No vuelvas a enviar la solicitud de música ni construyas una URL de consulta de generación a partir de operation_id.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Camporesponse_id | Tipostring |
Campodata[] | Tipoowned clip record |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una revisión | Siguiente pasoConserva el ID original de operación o tarea devuelto, los encabezados de la solicitud y la respuesta; continúa con las consultas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Alias
Alias del modelo
Ailoot google/lyria-3-clip-preview
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Lyria 3 Clip Preview
- ¿Qué entradas y resultados están disponibles?
POST /v1/music/generations·google/lyria-3-clip-preview:text→music- ¿Qué campos utiliza la solicitud?
POST /v1/music/generations·google/lyria-3-clip-preview:model,prompt