suno-api
Το Suno δημιουργεί μουσική από μια σύντομη γραπτή ιδέα. Η τεκμηριωμένη αυτόματη ροή εργασίας παράγει δύο τραγούδια και περιλαμβάνει επιλογή για μουσική χωρίς φωνητικά, ενώ ο ολοκληρωμένος ήχος και τα μεταδεδομένα των κομματιών επιστρέφονται μέσω της εργασίας δημιουργίας.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Suno είναι υπηρεσία δημιουργίας μουσικής που μετατρέπει μια γραπτή ιδέα σε τραγούδια. Η τεκμηριωμένη αυτόματη ροή εργασίας δέχεται μια σύντομη περιγραφή της επιθυμητής μουσικής και μια επιλογή για μουσική χωρίς φωνητικά και κατόπιν δημιουργεί δύο τραγούδια. Χρησιμοποιήστε την περιγραφή για να καθορίσετε το θέμα, τη διάθεση και τη μουσική κατεύθυνση που θέλετε να ακούσετε στα ολοκληρωμένα κομμάτια.
Ξεκινήστε από τον ρόλο που πρέπει να παίξει η μουσική. Ένα ήρεμο μουσικό υπόβαθρο για μια επεξήγηση, μια δυναμική εισαγωγή για ένα σύντομο βίντεο ή ένα στοχαστικό τραγούδι για ένα ταξίδι δίνουν στην περιγραφή έναν συγκεκριμένο σκοπό. Περιγράψτε την επιθυμητή διάθεση και τα μουσικά χαρακτηριστικά που έχουν σημασία για αυτόν τον σκοπό με λίγες σαφείς φράσεις.
Για ένα τραγούδι με φωνητικά, κάντε σαφές το θέμα και τη γλώσσα στις δημιουργικές οδηγίες. Περιγράψτε την ιδέα που πρέπει να εκφράζει το κομμάτι και το ύφος που πρέπει να μεταδίδει η ερμηνεία. Ακούστε το ολοκληρωμένο αποτέλεσμα για να διαπιστώσετε πώς λειτουργούν μαζί η φωνή, οι στίχοι και η ενορχήστρωση. Διατηρήστε τις πληροφορίες του παραγόμενου κομματιού μαζί με τον ήχο για τον έλεγχο.
Για ένα αποτέλεσμα χωρίς φωνητικά, χρησιμοποιήστε την τεκμηριωμένη επιλογή για μουσική χωρίς φωνητικά και περιγράψτε τη μουσική κατεύθυνση στο κείμενο. Αναφέρετε την επιθυμητή ατμόσφαιρα και τα κυρίαρχα όργανα όταν έχουν σημασία για το έργο. Ελέγξτε το ολοκληρωμένο κομμάτι ως προς τη θέση που θα έχει στο μοντάζ, συμπεριλαμβάνοντας τα τμήματα που χρειάζεται να ακούγονται κάτω από ομιλία ή να υποστηρίζουν μια οπτική μετάβαση.
Η αυτόματη ροή εργασίας παράγει δύο τραγούδια από την ιδέα που υποβάλλετε. Αντιμετωπίστε τα ως ξεχωριστές υποψήφιες επιλογές και διατηρήστε και τα δύο ολοκληρωμένα αρχεία ήχου. Ακούστε την αρχή, την εξέλιξη και το τέλος του καθενός. Συγκρίνετε τα πραγματικά κομμάτια με βάση τον ίδιο σκοπό, συμπεριλαμβάνοντας τη διάθεση, την ενορχήστρωση και την καταλληλότητά τους για την προβλεπόμενη χρήση.
Η δημιουργία οργανώνεται ως εργασία. Κρατήστε το αναγνωριστικό εργασίας που επιστρέφεται όταν ελέγχετε το αποτέλεσμά της και διαχωρίστε τα ολοκληρωμένα κομμάτια από όσα βρίσκονται ακόμη σε εξέλιξη. Το τεκμηριωμένο αποτέλεσμα περιλαμβάνει πληροφορίες ανά κομμάτι, όπως τίτλο, κατάσταση, τοποθεσία αρχείου ήχου και διάρκεια. Αποθηκεύστε τον ίδιο τον ολοκληρωμένο ήχο μαζί με τα διαθέσιμα μεταδεδομένα και την αρχική περιγραφή.
Για ένα βίντεο ή μια παρουσίαση, δοκιμάστε την επιλεγμένη μουσική μαζί με το πραγματικό υλικό. Ελέγξτε την αρχή, τις μεταβάσεις και το τέλος στην προβλεπόμενη ένταση ακρόασης. Σημειώστε το τμήμα που εξυπηρετεί το μοντάζ και διατηρήστε ολόκληρο το κομμάτι για μεταγενέστερες αλλαγές. Ένα κατάλληλο μουσικό απόσπασμα κρίνεται σε συνδυασμό με τη φωνή, τις εικόνες και τον ρυθμό του ολοκληρωμένου έργου.
Κρατήστε μαζί τη γραπτή ιδέα, την επιλογή για μουσική χωρίς φωνητικά, την επιλογή μοντέλου και όλα τα ολοκληρωμένα κομμάτια. Όταν μια υποψήφια επιλογή χρειάζεται αναθεώρηση, προσδιορίστε τη μουσική απόκλιση, όπως μια ενορχήστρωση που είναι πολύ πυκνή κάτω από την ομιλία ή μια εισαγωγή που εξελίσσεται πολύ αργά. Διατηρήστε τη χρήσιμη κατεύθυνση και αναθεωρήστε το μέρος της περιγραφής που συνδέεται με αυτό το πρόβλημα.
Ailoot Ultra · Music POST /v1/music/generations suno-api
suno-apiΕισαγωγή
Το Suno δημιουργεί μουσική από μια σύντομη γραπτή ιδέα. Η τεκμηριωμένη αυτόματη ροή εργασίας παράγει δύο τραγούδια και περιλαμβάνει επιλογή για μουσική χωρίς φωνητικά, ενώ ο ολοκληρωμένος ήχος και τα μεταδεδομένα των κομματιών επιστρέφονται μέσω της εργασίας δημιουργίας.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Ήχος · Εικόνες · Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Music POST /v1/music/generations
- Είσοδος
text- Έξοδος
audio,image,video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια suno-api Συνθήκες: Χρησιμοποιήστε ακριβώς αυτόν τον επιλογέα δρομολόγησης του Ailoot. | Προεπιλογή— |
Πεδίοgpt_description_prompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Περιγράψτε τη μουσική ιδέα ή το θέμα του τραγουδιού. | Προεπιλογή— |
Πεδίοmv | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Συνθήκες: Επιλέξτε ρητά μια τεκμηριωμένη έκδοση του Suno· το παράδειγμα χρησιμοποιεί chirp-crow (v5). | Προεπιλογή— |
Πεδίοmake_instrumental | Τύποςboolean | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Ορίστε true για οργανική μουσική ή false για τραγούδι. | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, gpt_description_prompt, mv, make_instrumental |
Παράμετροςoptional | Σύμβαση |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςconditions | ΣύμβασηΧρησιμοποιήστε ακριβώς αυτόν τον επιλογέα δρομολόγησης του Ailoot., Περιγράψτε τη μουσική ιδέα ή το θέμα του τραγουδιού., Επιλέξτε ρητά μια τεκμηριωμένη έκδοση του Suno· το παράδειγμα χρησιμοποιεί chirp-crow (v5)., Ορίστε true για οργανική μουσική ή false για τραγούδι. |
Κύκλος ζωής: submit_once_poll_original
GET /v1/music/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Ποσότητα τιμολόγησης | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Ποσότητα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΑνά αίτημα | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Ποσότητα τιμολόγησηςένα αίτημα | Χρέωση Είσοδος · Εκτίμηση μόνο για σύγκριση $0.2 ανά αίτημα |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Ποσότητα τιμολόγησης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.2 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "suno-api",
"gpt_description_prompt": "古诗词",
"mv": "chirp-crow",
"make_instrumental": false
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Music
Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/music/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, τα αρχικά αναγνωριστικά, κάθε πραγματική έξοδο και όλα τα πεδία χρήσης και λογιστικής καταγραφής. Αποθηκεύστε κάθε μοναδικό αρχείο πολυμέσων που σας ανήκει και διατηρήστε κάθε ρόλο που παραπέμπει σε αυτό.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το δημόσιο id εργασίας ή λειτουργίας που επιστρέφεται και όλες τις κεφαλίδες. Διαβάστε μόνο την αρχική εργασία· τα unknown ή result_pending_check δεν επιτρέπουν άλλη δημιουργία.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοpolling_url | Τύποςstring |
Πεδίοprovider_task_id | Τύποςstring |
Πεδίοdata.task_id | Τύποςstring |
Πεδίοdata.status | Τύποςstring |
Πεδίοdata.data[].audio_url | Τύποςstring |
Πεδίοdata.data[].image_url | Τύποςstring |
Πεδίοdata.data[].image_large_url | Τύποςstring |
Πεδίοdata.data[].video_url | Τύποςstring |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra suno-api
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · suno-api
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/music/generations·suno-api:text→audio,image,video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/music/generations·suno-api:model,gpt_description_prompt,mv,make_instrumental