Lyria
Παραγωγή μουσικής από κείμενο, με ένα έως οκτώ ζητούμενα αποσπάσματα και σύγχρονη παράδοση αποτελέσματος.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το google/lyria δημιουργεί μουσική από γραπτή προτροπή μέσω του /v1/music/generations. Συγκεκριμένη χρήση είναι το αίτημα για διακριτικό ορχηστρικό υπόβαθρο επίδειξης προϊόντος, περιγράφοντας τα κύρια όργανα και πόσο χώρο χρειάζεται η αφήγηση. Επιλέξτε αυτή τη διαδρομή όταν το επιθυμητό αποτέλεσμα είναι παραγόμενο μουσικό απόσπασμα.
Το αίτημα απαιτεί model και prompt. Ο έλεγχος n ή count δέχεται ένα έως οκτώ αποσπάσματα και η μέθοδος επιστρέφει το αποτέλεσμα παραγωγής συγχρονισμένα. Αποθηκεύστε κάθε επιστρεφόμενο απόσπασμα και τα πραγματικά μεταδεδομένα του. Αυτή η καταχώριση δεν εκθέτει είσοδο ηχητικής αναφοράς, ρύθμιση διάρκειας ή πεδίο τέμπο, επομένως αυτά δεν είναι ανεξάρτητα επιλέξιμοι έλεγχοι. Περιγράψτε τη μουσική πρόθεση στην προτροπή χωρίς να τη θεωρείτε εγγυημένη μετρημένη ιδιότητα της εξόδου.
Ailoot · Μουσική POST /v1/music/generations google/lyria
google/lyriaΕισαγωγή
Παραγωγή μουσικής από κείμενο, με ένα έως οκτώ ζητούμενα αποσπάσματα και σύγχρονη παράδοση αποτελέσματος.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- music
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot · Μουσική POST /v1/music/generations
- Είσοδος
text- Έξοδος
music- Μορφή εξόδου
- πλήρη αποσπάσματα ήχου που σας ανήκουν / σύνδεσμοι JSON
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/lyria | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 8 | Προεπιλογή1 |
Πεδίοcount | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 8 Συνθήκες: Αν δοθεί και n, το πλήθος πρέπει να συμφωνεί | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
text_to_music · Υποχρεωτικό: prompt
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςrequired | Σύμβασηnull |
Παράμετροςoptional_controls | Σύμβασηnull |
Κύκλος ζωής: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Το πραγματικό task_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.
Τιμολόγηση
Χρεώσεις μεθόδων Ailoot
POST /v1/music/generations- Έξοδος
- 0,08 $ ανά απόσπασμα
- Μόνο αναφορά · δεν προστίθεται
- 0,08 $ ανά αίτημα
Παραδοθέντα κλιπ × βασική τιμή ανά κλιπ. Η τιμή αναφοράς ανά αίτημα δεν προστίθεται. Παραδείγματα πριν από τις ισχύουσες προσαρμογές.
1 × 0,08 $ = 0,08 $
4 × 0,08 $ = 0,32 $
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot · Μουσική
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
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot · Μουσική
πλήρη αποσπάσματα ήχου που σας ανήκουν / σύνδεσμοι JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Αποθηκεύστε ή ανακτήστε κάθε απόσπασμα που επιστρέφεται και διατηρήστε το πραγματικό ID, τον MIME και τα μεταδεδομένα. Η μέθοδος είναι σύγχρονη· δεν εισάγεται ξεχωριστό URL περιοδικού ελέγχου για δημιουργία μουσικής στο Ailoot.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Αν ένα μουσικό αποτέλεσμα απαιτεί έλεγχο, διατηρήστε το αρχικό operation_id/X-Client-Request-ID και τις πληροφορίες αποσπάσματος που επιστρέφονται. Ανακτήστε υπάρχοντα αποσπάσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων, χρησιμοποιώντας πραγματικές τιμές task_id ή asset_id. Μην επανυποβάλετε το αίτημα μουσικής και μην κατασκευάσετε URL περιοδικού ελέγχου δημιουργίας από το operation_id.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοmodel | Τύποςstring |
Πεδίοresponse_id | Τύποςstring |
Πεδίοdata[] | Τύποςowned clip record |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot google/lyria
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Lyria
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/music/generations·google/lyria:text→music- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/music/generations·google/lyria:model,prompt,n,count- Ποια όρια ισχύουν;
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8