google/lyria crea musica da un prompt scritto tramite /v1/music/generations. Puoi chiedere una base strumentale sobria per una dimostrazione di prodotto, indicando strumenti in primo piano e spazio necessario alla voce. Scegli la rotta quando serve un clip musicale generato.
La richiesta richiede model e prompt. n o count accetta da uno a otto clip e il risultato è restituito sincronicamente. Salva ogni clip e i suoi metadati effettivi. Non sono esposti riferimenti audio, durata o tempo musicale come campi: non sono controlli indipendenti. Descrivi l’intento nel prompt senza considerarlo una proprietà misurata garantita dell’output.
", "aboutText": "google/lyria crea musica da un prompt scritto tramite /v1/music/generations. Puoi chiedere una base strumentale sobria per una dimostrazione di prodotto, indicando strumenti in primo piano e spazio necessario alla voce. Scegli la rotta quando serve un clip musicale generato. La richiesta richiede model e prompt. n o count accetta da uno a otto clip e il risultato è restituito sincronicamente. Salva ogni clip e i suoi metadati effettivi. Non sono esposti riferimenti audio, durata o tempo musicale come campi: non sono controlli indipendenti. Descrivi l’intento nel prompt senza considerarlo una proprietà misurata garantita dell’output.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria crea musica da un prompt scritto tramite /v1/music/generations. Puoi chiedere una base strumentale sobria per una dimostrazione di prodotto, indicando strumenti in primo piano e spazio necessario alla voce. Scegli la rotta quando serve un clip musicale generato.
La richiesta richiede model e prompt. n o count accetta da uno a otto clip e il risultato è restituito sincronicamente. Salva ogni clip e i suoi metadati effettivi. Non sono esposti riferimenti audio, durata o tempo musicale come campi: non sono controlli indipendenti. Descrivi l’intento nel prompt senza considerarlo una proprietà misurata garantita dell’output.
", "short_text": "Generazione di musica da testo con richiesta da uno a otto clip e risultato sincrono." }, "copy_sha256": "f2485a68dbfc0fafdd860c4c3cf0fe0db771c9826041fc93ad2c0add3c700766", "copy_source": { "locale": "it", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "3e6579c65bd1c917dc311cf5c49150785ddabe599c9c90fe51f4badace30a99c", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "69c34886e05471c992d25e0f703a164e1004f2f2d12b9b6186a9e87354f3ea8c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "google/lyriaGenerazione di musica da testo con richiesta da uno a otto clip e risultato sincrono.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
google/lyria crea musica da un prompt scritto tramite /v1/music/generations. Puoi chiedere una base strumentale sobria per una dimostrazione di prodotto, indicando strumenti in primo piano e spazio necessario alla voce. Scegli la rotta quando serve un clip musicale generato.
La richiesta richiede model e prompt. n o count accetta da uno a otto clip e il risultato è restituito sincronicamente. Salva ogni clip e i suoi metadati effettivi. Non sono esposti riferimenti audio, durata o tempo musicale come campi: non sono controlli indipendenti. Descrivi l’intento nel prompt senza considerarlo una proprietà misurata garantita dell’output.
POST /v1/music/generationstextmusic| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti google/lyria | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Campon | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 8 | Predefinito1 |
Campocount | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 8 Condizioni: Se viene fornito anche n, il conteggio deve coincidere | Predefinito— |
text_to_music · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametromaterial_types | Contrattotext |
Parametrorequired | Contrattonull |
Parametrooptional_controls | Contrattonull |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effettivamente restituito o record della libreria multimediale
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Le strutture dei metodi e gli ID sono esatti; la capacità del fornitore è distinta dall’ammissione delle richieste.
POST /v1/music/generationsClip consegnate × tariffa base per clip. Il riferimento per richiesta non si aggiunge. Esempi prima degli adeguamenti applicabili.
1 × 0,08 USD = 0,08 USD
4 × 0,08 USD = 0,32 USD
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
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\nclip audio complete di tua proprietà / collegamenti JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Conserva ogni risposta, file e parte di contenuto restituiti per intero.
Salva o recupera ogni clip restituita e conserva ID effettivo, MIME e metadati. Il metodo è sincrono; non viene introdotto un URL Ailoot separato per interrogare periodicamente la generazione musicale.
Se un risultato musicale richiede una verifica, conserva operation_id/X-Client-Request-ID originali e le informazioni delle clip restituite. Recupera le clip esistenti di tua proprietà dalla libreria multimediale usando valori reali di task_id o asset_id. Non inviare nuovamente la richiesta musicale e non costruire un URL di interrogazione della generazione a partire da operation_id.
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Camporesponse_id | Tipostring |
Campodata[] | Tipoowned clip record |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Ailoot google/lyria
Usa i percorsi dei metodi indicati sopra.