google/lyria creates music from a written prompt through /v1/music/generations. A concrete use is requesting a restrained instrumental bed for a product demonstration, describing the foreground instruments and how much space the narration needs. Choose this route when a generated music clip is the desired result.
The request requires model and prompt. The n or count control accepts one to eight clips, and the method returns its generation result synchronously. Save every returned clip and its actual metadata. This entry does not expose audio-reference input, a duration setting or a tempo field, so those are not independently selectable controls. Describe musical intent in the prompt without treating it as a guaranteed measured property of the output.
", "aboutText": "google/lyria creates music from a written prompt through /v1/music/generations. A concrete use is requesting a restrained instrumental bed for a product demonstration, describing the foreground instruments and how much space the narration needs. Choose this route when a generated music clip is the desired result. The request requires model and prompt. The n or count control accepts one to eight clips, and the method returns its generation result synchronously. Save every returned clip and its actual metadata. This entry does not expose audio-reference input, a duration setting or a tempo field, so those are not independently selectable controls. Describe musical intent in the prompt without treating it as a guaranteed measured property of the output.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria creates music from a written prompt through /v1/music/generations. A concrete use is requesting a restrained instrumental bed for a product demonstration, describing the foreground instruments and how much space the narration needs. Choose this route when a generated music clip is the desired result.
The request requires model and prompt. The n or count control accepts one to eight clips, and the method returns its generation result synchronously. Save every returned clip and its actual metadata. This entry does not expose audio-reference input, a duration setting or a tempo field, so those are not independently selectable controls. Describe musical intent in the prompt without treating it as a guaranteed measured property of the output.
", "short_text": "Text-to-music generation with one to eight requested clips and synchronous result delivery." }, "copy_sha256": "366f2bb848467bb25ff0f6bf75b138b7f8a2154ec3a3f76dcdbbc4088f15af9e", "copy_source": { "locale": "en", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "75aa20b108e22e30190171009423c1086a8fdf09b6b6c36dc75580c5bfddf020", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "d6e2a9ff3fbf40688225d4e7f602658ca9c7b648cf95e98e3f36432c85ed8e15", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "en", "methods": [ { "html": "google/lyriaText-to-music generation with one to eight requested clips and synchronous result delivery.
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
google/lyria creates music from a written prompt through /v1/music/generations. A concrete use is requesting a restrained instrumental bed for a product demonstration, describing the foreground instruments and how much space the narration needs. Choose this route when a generated music clip is the desired result.
The request requires model and prompt. The n or count control accepts one to eight clips, and the method returns its generation result synchronously. Save every returned clip and its actual metadata. This entry does not expose audio-reference input, a duration setting or a tempo field, so those are not independently selectable controls. Describe musical intent in the prompt without treating it as a guaranteed measured property of the output.
POST /v1/music/generationstextmusic| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits google/lyria | Default— |
Fieldprompt | Typestring | RequirementRequired | Values & limits Minimum length: 1 | Default— |
Fieldn | Typeinteger | RequirementOptional | Values & limits Minimum: 1 Maximum: 8 | Default1 |
Fieldcount | Typeinteger | RequirementOptional | Values & limits Minimum: 1 Maximum: 8 Conditions: Ifnalso supplied, countmustagree | Default— |
text_to_music · Required: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractnull |
Parameteroptional_controls | Contractnull |
Lifecycle: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · actual returned task_id or media library record
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Method shapes and IDs are exact; supplier capability is separate from admission.
POST /v1/music/generationsDelivered clips × base clip rate. The per-request reference is not added. Examples are before applicable adjustments.
1 × $0.08 = $0.08
4 × $0.08 = $0.32
Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
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\ncomplete owned audio clips / JSON links
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Keep every complete returned response, file and content part.
Save/fetch every returned clip and preserve actual ID, MIME and metadata. The method is synchronous; no separate Ailoot music generationpollingURL is introduced.
If a music result requires a check, keep the original operation_id/X-Client-Request-ID and returned clip information. Recover existing owned clips through the media library using actual task_id or asset_id values. Do not resubmit the music request or construct a generation polling URL from operation_id.
| Field | Type |
|---|---|
Fieldmodel | Typestring |
Fieldresponse_id | Typestring |
Fielddata[] | Typeowned clip record |
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionInvalid required fields, material representation or parameter value | Next stepCorrect the indicated fields before a new creation request. |
Responseserver_error | ConditionThe returned response says the operation or result requires a check | Next stepKeep the original returned operation/task ID, request headers and response; continue supported reads of that original operation. Do not resubmit the creation request. |
Ailoot google/lyria
Use the method paths shown above.