{ "aboutHtml": "

google/lyria luo musiikkia kirjallisesta kehotteesta /v1/music/generations-päätepisteessä. Konkreettinen käyttö on hillityn instrumentaalitaustan pyytäminen tuote-esittelyyn kuvaamalla etualan soittimet ja kerronnan tarvitsema tila. Valitse reitti, kun haluttu tulos on generoitu musiikkileike.

Pyyntö vaatii model- ja prompt-kentät. n- tai count-säädin hyväksyy yhdestä kahdeksaan leikettä, ja menetelmä palauttaa generointituloksen synkronisesti. Tallenna jokainen palautettu leike ja sen todellinen metadata. Merkintä ei tarjoa ääniviitesyötettä, kestoasetusta tai tempokenttää, joten ne eivät ole itsenäisesti valittavia säätimiä. Kuvaile musiikillinen tarkoitus kehotteessa pitämättä sitä tuloksen taattuna mitattuna ominaisuutena.

", "aboutText": "google/lyria luo musiikkia kirjallisesta kehotteesta /v1/music/generations-päätepisteessä. Konkreettinen käyttö on hillityn instrumentaalitaustan pyytäminen tuote-esittelyyn kuvaamalla etualan soittimet ja kerronnan tarvitsema tila. Valitse reitti, kun haluttu tulos on generoitu musiikkileike. Pyyntö vaatii model- ja prompt-kentät. n- tai count-säädin hyväksyy yhdestä kahdeksaan leikettä, ja menetelmä palauttaa generointituloksen synkronisesti. Tallenna jokainen palautettu leike ja sen todellinen metadata. Merkintä ei tarjoa ääniviitesyötettä, kestoasetusta tai tempokenttää, joten ne eivät ole itsenäisesti valittavia säätimiä. Kuvaile musiikillinen tarkoitus kehotteessa pitämättä sitä tuloksen taattuna mitattuna ominaisuutena.", "editorialOverlay": { "copy_fields": { "about_html": "

google/lyria luo musiikkia kirjallisesta kehotteesta /v1/music/generations-päätepisteessä. Konkreettinen käyttö on hillityn instrumentaalitaustan pyytäminen tuote-esittelyyn kuvaamalla etualan soittimet ja kerronnan tarvitsema tila. Valitse reitti, kun haluttu tulos on generoitu musiikkileike.

Pyyntö vaatii model- ja prompt-kentät. n- tai count-säädin hyväksyy yhdestä kahdeksaan leikettä, ja menetelmä palauttaa generointituloksen synkronisesti. Tallenna jokainen palautettu leike ja sen todellinen metadata. Merkintä ei tarjoa ääniviitesyötettä, kestoasetusta tai tempokenttää, joten ne eivät ole itsenäisesti valittavia säätimiä. Kuvaile musiikillinen tarkoitus kehotteessa pitämättä sitä tuloksen taattuna mitattuna ominaisuutena.

", "short_text": "Tekstistä musiikiksi -generointi yhdestä kahdeksaan pyydetyllä leikkeellä ja synkronisella tulostoimituksella." }, "copy_sha256": "920f80985171109ab1fbd82e59f54e12ef8020ad491c592aaff8a70ff356dbce", "copy_source": { "locale": "fi", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "bc0c195dfa7abd0165bbc6ec1a0d98c182c6b0db5c43d4af27c5c3d0e4fa0b38", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "acaacfa3bacfc51aa2d0a343878d17aad1961c50768d0e7635a517cb67b3030a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "
G

Lyria

Google /google/lyria

Aloitus

Tekstistä musiikiksi -generointi yhdestä kahdeksaan pyydetyllä leikkeellä ja synkronisella tulostoimituksella.

Hyväksytyt syötteet
Teksti
Tulokset
music
Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

google/lyria luo musiikkia kirjallisesta kehotteesta /v1/music/generations-päätepisteessä. Konkreettinen käyttö on hillityn instrumentaalitaustan pyytäminen tuote-esittelyyn kuvaamalla etualan soittimet ja kerronnan tarvitsema tila. Valitse reitti, kun haluttu tulos on generoitu musiikkileike.

Pyyntö vaatii model- ja prompt-kentät. n- tai count-säädin hyväksyy yhdestä kahdeksaan leikettä, ja menetelmä palauttaa generointituloksen synkronisesti. Tallenna jokainen palautettu leike ja sen todellinen metadata. Merkintä ei tarjoa ääniviitesyötettä, kestoasetusta tai tempokenttää, joten ne eivät ole itsenäisesti valittavia säätimiä. Kuvaile musiikillinen tarkoitus kehotteessa pitämättä sitä tuloksen taattuna mitattuna ominaisuutena.

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot · Musiikki POST /v1/music/generations
Syötetyypit
text
Tulostyypit
music
Tulosteen muoto
kokonaiset käyttäjälle kuuluvat äänileikkeet / JSON-linkit
KenttäTyyppiVaatimusArvot & rajatOletus
KenttämodelTyyppistringVaatimusPakollinenArvot & rajat
google/lyria
Oletus—
KenttäpromptTyyppistringVaatimusPakollinenArvot & rajat
Vähimmäispituus: 1
Oletus—
KenttänTyyppiintegerVaatimusValinnainenArvot & rajat
Vähimmäismäärä: 1
Enimmäismäärä: 8
Oletus1
KenttäcountTyyppiintegerVaatimusValinnainenArvot & rajat
Vähimmäismäärä: 1
Enimmäismäärä: 8
Ehdot: Jos myös n annetaan, lukumäärien on täsmättävä
Oletus—
Syöteaineistojen yhdistelmät

text_to_music · Pakollinen: prompt

Menetelmän parametrit ja elinkaari
ParametriSopimus
Parametrimaterial_typesSopimustext
ParametrirequiredSopimusnull
Parametrioptional_controlsSopimusnull

Elinkaari: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä.

Hinnoittelu

Ailoot-menetelmien hinnat

Ailoot MusiikkiPOST /v1/music/generations
Tuloste
0,08 $ leikettä kohden
Vain viite · ei lisätä
0,08 $ pyyntöä kohden

Toimitetut leikkeet × leikkeen perushinta. Pyyntökohtaista viitehintaa ei lisätä. Esimerkit ennen sovellettavia muutoksia.

1 × 0,08 $ = 0,08 $

4 × 0,08 $ = 0,32 $

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot · Musiikki

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\n

Vastaanota ja tallenna tulokset

Ailoot · Musiikki

kokonaiset käyttäjälle kuuluvat äänileikkeet / JSON-linkit

Säilytä kaikki valmistuneet tulokset

Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.

Tallenna tai nouda jokainen palautettu leike ja säilytä sen todellinen tunniste, MIME-tyyppi ja metatiedot. Menetelmä on synkroninen; erillistä Ailoot-musiikinluonnin tilakyselyosoitetta ei oteta käyttöön.

Jos alkuperäinen vastaus on tarkistettava

Jos musiikkitulos edellyttää tarkistusta, säilytä alkuperäinen operation_id/X-Client-Request-ID ja palautettujen leikkeiden tiedot. Palauta olemassa olevat käyttäjälle kuuluvat leikkeet mediakirjastosta todellisilla task_id- tai asset_id-arvoilla. Älä lähetä musiikkipyyntöä uudelleen äläkä muodosta luontityön tilakyselyn URL-osoitetta operation_id-arvosta.

Vastauksen kentät
KenttäTyyppi
KenttämodelTyyppistring
Kenttäresponse_idTyyppistring
Kenttädata[]Tyyppiowned clip record
Virheet ja seuraavat vaiheet
VastausEhtoSeuraava vaihe
Vastaus400 · invalid_request_errorEhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvoSeuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä.
Vastausserver_errorEhtoPalautettu vastaus ilmoittaa, että operaatio tai tulos edellyttää tarkistustaSeuraava vaiheSäilytä alkuperäinen palautettu operaation tai tehtävän ID, pyynnön otsakkeet ja vastaus; jatka kyseisen alkuperäisen operaation tuettuja lukutoimintoja. Älä lähetä luontipyyntöä uudelleen.

Aliakset

Mallin aliakset

Ailoot google/lyria

Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

Liittyvät kutsujan ID:t

google/lyria

", "method_identity": { "effective_request_model_id": "google/lyria", "fmt": "music", "http": "POST", "path": "/v1/music/generations", "request_model_id": "google/lyria", "route_label": "Core" }, "method_key": "Core|music|/v1/music/generations|google%2Flyria", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save/fetch every returned clip and preserve actual ID, MIME and metadata. The method is synchronous; no separate Ailoot music generationpollingURL is introduced.", "errors": [ { "code": null, "condition": "Virheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo", "http_status": 400, "recovery": "Korjaa ilmoitetut kentät ennen uutta luontipyyntöä.", "type": "invalid_request_error" }, { "code": null, "condition": "Palautettu vastaus ilmoittaa, että operaatio tai tulos edellyttää tarkistusta", "http_status": null, "recovery": "Säilytä alkuperäinen palautettu operaation tai tehtävän ID, pyynnön otsakkeet ja vastaus; jatka kyseisen alkuperäisen operaation tuettuja lukutoimintoja. Älä lähetä luontipyyntöä uudelleen.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Jos musiikkitulos edellyttää tarkistusta, säilytä alkuperäinen operation_id/X-Client-Request-ID ja palautettujen leikkeiden tiedot. Palauta olemassa olevat käyttäjälle kuuluvat leikkeet mediakirjastosta todellisilla task_id- tai asset_id-arvoilla. Älä lähetä musiikkipyyntöä uudelleen äläkä muodosta luontityön tilakyselyn URL-osoitetta operation_id-arvosta." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_music", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_music" ], "outputs": { "all_results": "Tallenna tai nouda jokainen palautettu leike ja säilytä sen todellinen tunniste, MIME-tyyppi ja metatiedot. Menetelmä on synkroninen; erillistä Ailoot-musiikinluonnin tilakyselyosoitetta ei oteta käyttöön.", "family": "music", "fields": [ { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "response_id", "type": "string" }, { "description": null, "name": "data[]", "type": "owned clip record" } ], "format": "kokonaiset käyttäjälle kuuluvat äänileikkeet / JSON-linkit" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/lyria" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "conditions": "Jos myös n annetaan, lukumäärien on täsmättävä", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "count", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [] }, "hints": [ "Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä." ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "todellisuudessa palautettu task_id tai mediakirjaston tietue", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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." }, "method": { "http": "POST", "path": "/v1/music/generations" }, "operation_modes": [ "music" ], "output": { "family": [ "music" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "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\n", "label": "Compose from your actual music brief", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Musiikki", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "music" ], "path": "/v1/music/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "music_output_clip", "label": "per clip", "side": "out" }, { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "per_request", "label": "per request", "side": "out" } ] } ], "request_model_id": "google/lyria", "route_label": "Core", "status_reads": [], "tiers": [], "tool_prices": null, "unit": "music_output_clip", "units": [ { "key": "music_output_clip", "label": "per clip", "side": "out", "usd": 0.08 }, { "key": "per_request", "label": "per request", "side": "out", "usd": 0.08 } ] } } ], "model_id": "google/lyria", "nativeProvenance": { "input_facts_canonical_sha256": "304cd2acdb3bc11d9479b62839b9a9f25016a24380038f28632558eac249d820", "input_html_sha256": "e410fcd3c06df22031ddbc3f693a390640a104d7ab5481da3dbcdb3874864ed9", "private_audit_sha256": "4bd5970264f4ca214c32daf5e1d0c95a73398e96c6b291efaf01e7788c44d6ed", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fi/google-lyria/", "description": "Tekstistä musiikiksi -generointi yhdestä kahdeksaan pyydetyllä leikkeellä ja synkronisella tulostoimituksella.", "locale": "fi", "md_url": "https://ailoot.ai/models/fi/google-lyria/index.md", "title": "Lyria — Ailoot", "url": "https://ailoot.ai/models/fi/google-lyria/" }, "rawModel": { "about": "Lyria on tässä esitelty nimetty musiikinluontiprofiili, jonka syöte on teksti ja tulos musiikki.\n\nLaadi ohje sen mukaan, mitä kuulijan tulee kuulla. Määritä tunnelma, etualalle haluamasi soittimet, tempo ja käyttötarkoitus. Kohtausohje voi erottaa hiljaisen alun, energisemmän keskiosan ja hillityn lopun.\n\nTaustamusiikkia varten selitä, tuleeko kappaleen tukea kerrontaa vai kannatella kohtausta itsenäisesti. Kuvaa musiikilliset ominaisuudet suoraan, kuten vähäeleinen piano, tasainen syke tai lämmin orkesterisointi.", "alias_of": null, "aliases": [], "author": "Google", "ctx": null, "formats": [ "music" ], "id": "google/lyria", "input": [ "text" ], "kind": "music", "max_out": null, "methods": [ { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save/fetch every returned clip and preserve actual ID, MIME and metadata. The method is synchronous; no separate Ailoot music generationpollingURL is introduced.", "errors": [ { "code": null, "condition": "Virheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo", "http_status": 400, "recovery": "Korjaa ilmoitetut kentät ennen uutta luontipyyntöä.", "type": "invalid_request_error" }, { "code": null, "condition": "Palautettu vastaus ilmoittaa, että operaatio tai tulos edellyttää tarkistusta", "http_status": null, "recovery": "Säilytä alkuperäinen palautettu operaation tai tehtävän ID, pyynnön otsakkeet ja vastaus; jatka kyseisen alkuperäisen operaation tuettuja lukutoimintoja. Älä lähetä luontipyyntöä uudelleen.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Jos musiikkitulos edellyttää tarkistusta, säilytä alkuperäinen operation_id/X-Client-Request-ID ja palautettujen leikkeiden tiedot. Palauta olemassa olevat käyttäjälle kuuluvat leikkeet mediakirjastosta todellisilla task_id- tai asset_id-arvoilla. Älä lähetä musiikkipyyntöä uudelleen äläkä muodosta luontityön tilakyselyn URL-osoitetta operation_id-arvosta." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_music", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_music" ], "outputs": { "all_results": "Tallenna tai nouda jokainen palautettu leike ja säilytä sen todellinen tunniste, MIME-tyyppi ja metatiedot. Menetelmä on synkroninen; erillistä Ailoot-musiikinluonnin tilakyselyosoitetta ei oteta käyttöön.", "family": "music", "fields": [ { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "response_id", "type": "string" }, { "description": null, "name": "data[]", "type": "owned clip record" } ], "format": "kokonaiset käyttäjälle kuuluvat äänileikkeet / JSON-linkit" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/lyria" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "conditions": "Jos myös n annetaan, lukumäärien on täsmättävä", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "count", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [] }, "hints": [ "Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä." ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "todellisuudessa palautettu task_id tai mediakirjaston tietue", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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." }, "method": { "http": "POST", "path": "/v1/music/generations" }, "operation_modes": [ "music" ], "output": { "family": [ "music" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "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\n", "label": "Compose from your actual music brief", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "Musiikki", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "music" ], "path": "/v1/music/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "music_output_clip", "label": "per clip", "side": "out" }, { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "per_request", "label": "per request", "side": "out" } ] } ], "request_model_id": "google/lyria", "route_label": "Core", "status_reads": [], "tiers": [], "tool_prices": null, "unit": "music_output_clip", "units": [ { "key": "music_output_clip", "label": "per clip", "side": "out", "usd": 0.08 }, { "key": "per_request", "label": "per request", "side": "out", "usd": 0.08 } ] } ], "model_aliases": [ { "canonical_model_id": "google/lyria", "request_model_id": "google/lyria", "route_label": "Core" } ], "name": "Lyria", "price": { "in": null, "in_label": null, "out": 0.08, "out_label": "per clip", "sort_in": null, "sort_out": null, "varies": false }, "short": "Lyria on nimetty profiili musiikin luomiseen tekstistä. Kuvaa tunnelma, soittimet, rytmi ja tarkoitettu kohtaus laatiaksesi musiikkiohjeen videolle, esitykselle tai luovalle projektille." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Tekstistä musiikiksi -generointi yhdestä kahdeksaan pyydetyllä leikkeellä ja synkronisella tulostoimituksella.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "1b5bdffaec9c2ef1b6a694b6b439e37e83128e2f508c9c1647173ad7c22c50f2", "renderer_sha256": "303a59603e2bc29ba8fda690e95fd32cec68de223d92e26054a88babff801dd7" }, "sourceRevision": "6b13fe29445e278feb2838c21dc24d102850d45ecbefd1a8d39045c12e4be6fc" }