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.
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.
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.
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.
", "aboutText": "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.\n\n### Describe el momento musical\n\nIndica 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.\n\nManté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.\n\n### Inspiración visual y arreglo\n\nAl 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.\n\nRevisa 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.\n\n### Conserva el resultado de audio\n\nGuarda 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.\n\nEste 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8ba4a0cac4e046ffcf9637afc24217373198c01fc4f6c15604b4b368a38371bf", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "google/lyria-3-clip-previewLyria 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.
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.
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.
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.
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.
POST /v1/music/generationstextmusic| 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— |
text_to_music · Obligatorio: prompt
| 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} · task_id real devuelto o 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.
POST /v1/music/generationsClips entregados × tarifa base por clip. La referencia por solicitud no se suma. Ejemplos antes de los ajustes aplicables.
1 × 0,04 US$ = 0,04 US$
Ailoot reserva un importe 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 →
Las tablas de referencia del modelo no cambian la selección del método, las estimaciones de coste ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
| Configuración | Nivel de servicio | Condición de contexto | Cargo |
|---|---|---|---|
| ConfiguraciónUltra | Nivel de serviciostandard | Condición de contexto{} | Cargo Salida · música 0,08 US$ por canción |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nexport AILOOT_API_KEY\npython3 - <<'PY_RESULT'\nimport json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin, urlparse\nresult=json.loads(Path("result.json").read_text(encoding="utf-8"))\nprint(json.dumps(result,ensure_ascii=False,indent=2))\nfor number,clip in enumerate(result.get("data") or []):\n u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))\n if u.scheme!="https" or not u.hostname or u.username or u.password:\n raise SystemExit("Result URL must be HTTPS without embedded credentials")\n owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n raw=subprocess.check_output(args)\n 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"\n f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)\n print("Saved",f,clip.get("asset_id"))\n\nPY_RESULT\nclips de audio completos bajo tu titularidad / enlaces JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Guarda o recupera todos los clips devueltos y conserva su ID real, MIME y metadatos. El método es síncrono; no se introduce una URL de consulta periódica independiente de Ailoot para la generación de música.
Si un resultado musical requiere una comprobación, conserva el operation_id/X-Client-Request-ID original y la información de los clips devueltos. Recupera los clips existentes bajo tu titularidad mediante la biblioteca de medios, utilizando valores reales de task_id o asset_id. No vuelvas a enviar la solicitud musical ni construyas una URL de consulta periódica de generación a partir de operation_id.
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Camporesponse_id | Tipostring |
Campodata[] | Tipoowned clip record |
| 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 comprobación | Siguiente pasoConserva el ID original de operación o tarea devuelto, las cabeceras de la solicitud y la respuesta; continúa con las lecturas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Ailoot google/lyria-3-clip-preview
Usa las rutas de método indicadas arriba.