google/lyria crea música desde un prompt escrito mediante /v1/music/generations. Puedes solicitar una base instrumental contenida para una demostración de producto, describiendo instrumentos principales y espacio para narración. Elige esta ruta si necesitas un clip musical generado.
Exige model y prompt. n o count admite entre uno y ocho clips y el resultado se devuelve de forma síncrona. Guarda cada clip devuelto y sus metadatos reales. No expone referencia de audio, duración ni tempo como controles independientes. Describe intención musical sin tratarla como una propiedad medida garantizada de la salida.
", "aboutText": "google/lyria crea música desde un prompt escrito mediante /v1/music/generations. Puedes solicitar una base instrumental contenida para una demostración de producto, describiendo instrumentos principales y espacio para narración. Elige esta ruta si necesitas un clip musical generado. Exige model y prompt. n o count admite entre uno y ocho clips y el resultado se devuelve de forma síncrona. Guarda cada clip devuelto y sus metadatos reales. No expone referencia de audio, duración ni tempo como controles independientes. Describe intención musical sin tratarla como una propiedad medida garantizada de la salida.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria crea música desde un prompt escrito mediante /v1/music/generations. Puedes solicitar una base instrumental contenida para una demostración de producto, describiendo instrumentos principales y espacio para narración. Elige esta ruta si necesitas un clip musical generado.
Exige model y prompt. n o count admite entre uno y ocho clips y el resultado se devuelve de forma síncrona. Guarda cada clip devuelto y sus metadatos reales. No expone referencia de audio, duración ni tempo como controles independientes. Describe intención musical sin tratarla como una propiedad medida garantizada de la salida.
", "short_text": "Generación de música desde texto, con entre uno y ocho clips solicitados y entrega síncrona." }, "copy_sha256": "042ff551999e17501bea1f6ccd89356a081a5d1120f7cc464710c368ee57351b", "copy_source": { "locale": "es-mx", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "2507fe218bbda7de7ebe6c79ebde72c219c232611eb6bdc693fb9ef551f31a88", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "e1a820b27d5f7115621be158fbcbab539dc5110015eaf15245dd3b7820ba8d2e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "google/lyriaGeneración de música desde texto, con entre uno y ocho clips solicitados y entrega síncrona.
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.
google/lyria crea música desde un prompt escrito mediante /v1/music/generations. Puedes solicitar una base instrumental contenida para una demostración de producto, describiendo instrumentos principales y espacio para narración. Elige esta ruta si necesitas un clip musical generado.
Exige model y prompt. n o count admite entre uno y ocho clips y el resultado se devuelve de forma síncrona. Guarda cada clip devuelto y sus metadatos reales. No expone referencia de audio, duración ni tempo como controles independientes. Describe intención musical sin tratarla como una propiedad medida garantizada de la salida.
POST /v1/music/generationstextmusic| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites google/lyria | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Campon | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 8 | Predeterminado1 |
Campocount | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 8 Condiciones: Si también se proporciona n, la cantidad debe coincidir | 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} · 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.
POST /v1/music/generationsClips entregados × tarifa base por clip. La referencia por solicitud no se suma. Ejemplos antes de los ajustes aplicables.
1 × USD 0.08 = USD 0.08
4 × USD 0.08 = USD 0.32
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 →
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", "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 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 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 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.
| 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 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. |
Ailoot google/lyria
Usa las rutas de método indicadas arriba.