google/lyria maakt muziek uit een geschreven prompt via /v1/music/generations. Vraag bijvoorbeeld rustige instrumentale achtergrondmuziek voor een productdemo en beschrijf voorgrondinstrumenten en de ruimte die de verteller nodig heeft. Kies deze route wanneer een muziekclip het gewenste resultaat is.
Het verzoek vereist model en prompt. n of count accepteert één tot acht clips en de methode geeft het generatieresultaat synchroon terug. Bewaar elke clip en de echte metadata. Audio-referentie-invoer, een duurinstelling of tempoveld ontbreken; die zijn niet apart te kiezen. Beschrijf muzikale bedoeling in de prompt zonder die als gegarandeerde gemeten uitvoereigenschap te behandelen.
", "aboutText": "google/lyria maakt muziek uit een geschreven prompt via /v1/music/generations. Vraag bijvoorbeeld rustige instrumentale achtergrondmuziek voor een productdemo en beschrijf voorgrondinstrumenten en de ruimte die de verteller nodig heeft. Kies deze route wanneer een muziekclip het gewenste resultaat is. Het verzoek vereist model en prompt. n of count accepteert één tot acht clips en de methode geeft het generatieresultaat synchroon terug. Bewaar elke clip en de echte metadata. Audio-referentie-invoer, een duurinstelling of tempoveld ontbreken; die zijn niet apart te kiezen. Beschrijf muzikale bedoeling in de prompt zonder die als gegarandeerde gemeten uitvoereigenschap te behandelen.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria maakt muziek uit een geschreven prompt via /v1/music/generations. Vraag bijvoorbeeld rustige instrumentale achtergrondmuziek voor een productdemo en beschrijf voorgrondinstrumenten en de ruimte die de verteller nodig heeft. Kies deze route wanneer een muziekclip het gewenste resultaat is.
Het verzoek vereist model en prompt. n of count accepteert één tot acht clips en de methode geeft het generatieresultaat synchroon terug. Bewaar elke clip en de echte metadata. Audio-referentie-invoer, een duurinstelling of tempoveld ontbreken; die zijn niet apart te kiezen. Beschrijf muzikale bedoeling in de prompt zonder die als gegarandeerde gemeten uitvoereigenschap te behandelen.
", "short_text": "Tekst-naar-muziek met één tot acht gevraagde clips en synchrone resultaatlevering." }, "copy_sha256": "bc88f6724cff8d2734e6b266ad871d7fc75a65767fcfa14b97324a397b236299", "copy_source": { "locale": "nl-be", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "12d48f675d21faa1672691ffe48b60cd0ed86d03a32cdc909cba8e9017314b8f", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "95be2738033d86a38413607c7e8964cb1720d87d0db75e2846826d47e40af48c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "google/lyriaTekst-naar-muziek met één tot acht gevraagde clips en synchrone resultaatlevering.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
google/lyria maakt muziek uit een geschreven prompt via /v1/music/generations. Vraag bijvoorbeeld rustige instrumentale achtergrondmuziek voor een productdemo en beschrijf voorgrondinstrumenten en de ruimte die de verteller nodig heeft. Kies deze route wanneer een muziekclip het gewenste resultaat is.
Het verzoek vereist model en prompt. n of count accepteert één tot acht clips en de methode geeft het generatieresultaat synchroon terug. Bewaar elke clip en de echte metadata. Audio-referentie-invoer, een duurinstelling of tempoveld ontbreken; die zijn niet apart te kiezen. Beschrijf muzikale bedoeling in de prompt zonder die als gegarandeerde gemeten uitvoereigenschap te behandelen.
POST /v1/music/generationstextmusic| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten google/lyria | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 8 | Standaard1 |
Veldcount | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 8 Voorwaarden: Als ook n is opgegeven, moet het aantal overeenkomen | Standaard— |
text_to_music · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractnull |
Parameteroptional_controls | Contractnull |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · daadwerkelijk teruggegeven task_id of record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/music/generationsGeleverde clips × basistarief per clip. Het referentietarief per verzoek wordt niet opgeteld. Voorbeelden vóór toepasselijke aanpassingen.
1 × US$ 0,08 = US$ 0,08
4 × US$ 0,08 = US$ 0,32
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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\nvolledige audioclips die je toebehoren / JSON-links
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Sla elke teruggestuurde clip op of haal die op en bewaar de werkelijke ID, MIME en metadata. De methode is synchroon; er wordt geen afzonderlijke Ailoot-URL voor het opvragen van de status van muziekgeneratie ingevoerd.
Als een muziekresultaat moet worden gecontroleerd, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de teruggestuurde clipinformatie. Haal bestaande clips die je toebehoren terug via de mediabibliotheek met werkelijke task_id- of asset_id-waarden. Dien de muziekaanvraag niet opnieuw in en stel geen URL voor het opvragen van de generatiestatus samen op basis van operation_id.
| Veld | Type |
|---|---|
Veldmodel | Typestring |
Veldresponse_id | Typestring |
Velddata[] | Typeowned clip record |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeDe teruggegeven respons geeft aan dat de bewerking of het resultaat gecontroleerd moet worden | Volgende stapBewaar de oorspronkelijk teruggegeven bewerkings-/taak-ID, aanvraagheaders en respons; blijf de oorspronkelijke bewerking uitlezen via de ondersteunde leesaanvragen. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot google/lyria
Gebruik de hierboven getoonde methodepaden.