Lyria
Generazione di musica da testo con richiesta da uno a otto clip e risultato sincrono.
Informazioni sul modello
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.
Ailoot · Musica POST /v1/music/generations google/lyria
google/lyriaIntroduzione
Generazione di musica da testo con richiesta da uno a otto clip e risultato sincrono.
- Input accettati
- Testo
- Risultati
- music
Disponibile in Ailoot · input e metodi
Ailoot · Musica POST /v1/music/generations
- Tipi di input
text- Tipi di output
music- Formato di output
- clip audio complete di tua proprietà / collegamenti JSON
| 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— |
Combinazioni di materiali in input
text_to_music · Obbligatorio: prompt
Parametri e ciclo di vita del metodo
| 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.
Tariffe
Tariffe dei metodi Ailoot
POST /v1/music/generations- Output
- 0,08 USD per clip
- Solo riferimento · non aggiunto
- 0,08 USD per richiesta
Clip 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 →
Esempi di richieste
Ailoot · Musica
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/lyria", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
export AILOOT_API_KEY
python3 - <<'PY_RESULT'
import json, os, subprocess
from pathlib import Path
from urllib.parse import urljoin, urlparse
result=json.loads(Path("result.json").read_text(encoding="utf-8"))
print(json.dumps(result,ensure_ascii=False,indent=2))
for number,clip in enumerate(result.get("data") or []):
u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))
if u.scheme!="https" or not u.hostname or u.username or u.password:
raise SystemExit("Result URL must be HTTPS without embedded credentials")
owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
raw=subprocess.check_output(args)
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"
f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)
print("Saved",f,clip.get("asset_id"))
PY_RESULT
Ricevi e salva i risultati
Ailoot · Musica
clip 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 tutti i risultati completati
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 occorre verificare la risposta originale
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.
Campi della risposta
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Camporesponse_id | Tipostring |
Campodata[] | Tipoowned clip record |
Errori e passaggi successivi
| 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. |
Alias
Alias del modello
Ailoot google/lyria
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Lyria
- Quali input e risultati sono disponibili?
POST /v1/music/generations·google/lyria:text→music- Quali campi usa la richiesta?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Quali limiti si applicano?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8