Suno è un servizio di generazione musicale che trasforma un'idea scritta in brani. Il flusso di lavoro automatico documentato accetta una breve descrizione della musica desiderata e l'impostazione dell'opzione strumentale, quindi genera due brani. Usa il brief per definire il tema, l'atmosfera e la direzione musicale che vuoi ascoltare nelle tracce completate.
Parti dal ruolo che la musica deve svolgere. Un sottofondo tranquillo per una spiegazione, un'apertura energica per un breve video o una canzone riflessiva su un viaggio danno ciascuno al brief uno scopo concreto. Descrivi l'atmosfera desiderata e le caratteristiche musicali rilevanti per quello scopo in poche frasi chiare.
Per una canzone con voce, rendi chiari il tema e la lingua nel brief creativo. Descrivi l'idea che il brano deve esprimere e il tono che l'interpretazione deve trasmettere. Ascolta il risultato completato per valutare come funzionano insieme la voce, le parole e l'arrangiamento. Conserva le informazioni generate sul brano insieme all'audio per la revisione.
Per un risultato strumentale, usa l'apposita opzione documentata e descrivi nel testo la direzione musicale. Indica l'atmosfera desiderata e gli strumenti in primo piano quando sono rilevanti per il progetto. Valuta la traccia completata in funzione del posto che occuperà nel montaggio, comprese le sezioni che devono accompagnare il parlato o sostenere una transizione visiva.
Il flusso di lavoro automatico produce due brani dall'idea inviata. Trattali come proposte distinte e conserva entrambi i file audio completati. Ascolta ogni brano dall'apertura, attraverso lo sviluppo, fino alla conclusione. Confronta le tracce effettive rispetto allo stesso scopo, considerando l'atmosfera, l'arrangiamento e l'idoneità all'uso pianificato.
La generazione è organizzata come un task. Conserva l'ID del task restituito mentre ne controlli il risultato e distingui le tracce completate dagli elementi ancora in corso. Il risultato documentato include informazioni per ogni traccia, come titolo, stato, posizione dell'audio e durata. Salva il file audio completato insieme ai metadati disponibili e al brief originale.
Per un video o una presentazione, prova la musica selezionata con il materiale reale. Controlla l'apertura, le transizioni e la conclusione al livello di ascolto previsto. Segna la sezione funzionale al montaggio e conserva la traccia completa per eventuali modifiche successive. Un estratto musicale adatto si valuta nel contesto della voce, delle immagini e del ritmo del prodotto completato.
Conserva insieme l'idea scritta, l'impostazione dell'opzione strumentale, la selezione del modello e tutte le tracce completate. Quando una proposta richiede una revisione, identifica la discrepanza musicale, come un arrangiamento troppo denso sotto il parlato o un'apertura che si sviluppa troppo lentamente. Mantieni la direzione utile e modifica la parte del brief collegata al problema.
", "aboutText": "Suno è un servizio di generazione musicale che trasforma un'idea scritta in brani. Il flusso di lavoro automatico documentato accetta una breve descrizione della musica desiderata e l'impostazione dell'opzione strumentale, quindi genera due brani. Usa il brief per definire il tema, l'atmosfera e la direzione musicale che vuoi ascoltare nelle tracce completate.\n\nParti dal ruolo che la musica deve svolgere. Un sottofondo tranquillo per una spiegazione, un'apertura energica per un breve video o una canzone riflessiva su un viaggio danno ciascuno al brief uno scopo concreto. Descrivi l'atmosfera desiderata e le caratteristiche musicali rilevanti per quello scopo in poche frasi chiare.\n\nPer una canzone con voce, rendi chiari il tema e la lingua nel brief creativo. Descrivi l'idea che il brano deve esprimere e il tono che l'interpretazione deve trasmettere. Ascolta il risultato completato per valutare come funzionano insieme la voce, le parole e l'arrangiamento. Conserva le informazioni generate sul brano insieme all'audio per la revisione.\n\nPer un risultato strumentale, usa l'apposita opzione documentata e descrivi nel testo la direzione musicale. Indica l'atmosfera desiderata e gli strumenti in primo piano quando sono rilevanti per il progetto. Valuta la traccia completata in funzione del posto che occuperà nel montaggio, comprese le sezioni che devono accompagnare il parlato o sostenere una transizione visiva.\n\nIl flusso di lavoro automatico produce due brani dall'idea inviata. Trattali come proposte distinte e conserva entrambi i file audio completati. Ascolta ogni brano dall'apertura, attraverso lo sviluppo, fino alla conclusione. Confronta le tracce effettive rispetto allo stesso scopo, considerando l'atmosfera, l'arrangiamento e l'idoneità all'uso pianificato.\n\nLa generazione è organizzata come un task. Conserva l'ID del task restituito mentre ne controlli il risultato e distingui le tracce completate dagli elementi ancora in corso. Il risultato documentato include informazioni per ogni traccia, come titolo, stato, posizione dell'audio e durata. Salva il file audio completato insieme ai metadati disponibili e al brief originale.\n\nPer un video o una presentazione, prova la musica selezionata con il materiale reale. Controlla l'apertura, le transizioni e la conclusione al livello di ascolto previsto. Segna la sezione funzionale al montaggio e conserva la traccia completa per eventuali modifiche successive. Un estratto musicale adatto si valuta nel contesto della voce, delle immagini e del ritmo del prodotto completato.\n\nConserva insieme l'idea scritta, l'impostazione dell'opzione strumentale, la selezione del modello e tutte le tracce completate. Quando una proposta richiede una revisione, identifica la discrepanza musicale, come un arrangiamento troppo denso sotto il parlato o un'apertura che si sviluppa troppo lentamente. Mantieni la direzione utile e modifica la parte del brief collegata al problema.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "dfe2a2e6323d1c632f856725a532d11c896a74f0584b31e051c4c616cf37d724", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "suno-apiSuno crea musica da una breve idea scritta. Il flusso di lavoro automatico documentato produce due brani e include un'opzione per generare brani strumentali; l'audio completato e i metadati dei brani vengono restituiti tramite il task di generazione.
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.
Suno è un servizio di generazione musicale che trasforma un'idea scritta in brani. Il flusso di lavoro automatico documentato accetta una breve descrizione della musica desiderata e l'impostazione dell'opzione strumentale, quindi genera due brani. Usa il brief per definire il tema, l'atmosfera e la direzione musicale che vuoi ascoltare nelle tracce completate.
Parti dal ruolo che la musica deve svolgere. Un sottofondo tranquillo per una spiegazione, un'apertura energica per un breve video o una canzone riflessiva su un viaggio danno ciascuno al brief uno scopo concreto. Descrivi l'atmosfera desiderata e le caratteristiche musicali rilevanti per quello scopo in poche frasi chiare.
Per una canzone con voce, rendi chiari il tema e la lingua nel brief creativo. Descrivi l'idea che il brano deve esprimere e il tono che l'interpretazione deve trasmettere. Ascolta il risultato completato per valutare come funzionano insieme la voce, le parole e l'arrangiamento. Conserva le informazioni generate sul brano insieme all'audio per la revisione.
Per un risultato strumentale, usa l'apposita opzione documentata e descrivi nel testo la direzione musicale. Indica l'atmosfera desiderata e gli strumenti in primo piano quando sono rilevanti per il progetto. Valuta la traccia completata in funzione del posto che occuperà nel montaggio, comprese le sezioni che devono accompagnare il parlato o sostenere una transizione visiva.
Il flusso di lavoro automatico produce due brani dall'idea inviata. Trattali come proposte distinte e conserva entrambi i file audio completati. Ascolta ogni brano dall'apertura, attraverso lo sviluppo, fino alla conclusione. Confronta le tracce effettive rispetto allo stesso scopo, considerando l'atmosfera, l'arrangiamento e l'idoneità all'uso pianificato.
La generazione è organizzata come un task. Conserva l'ID del task restituito mentre ne controlli il risultato e distingui le tracce completate dagli elementi ancora in corso. Il risultato documentato include informazioni per ogni traccia, come titolo, stato, posizione dell'audio e durata. Salva il file audio completato insieme ai metadati disponibili e al brief originale.
Per un video o una presentazione, prova la musica selezionata con il materiale reale. Controlla l'apertura, le transizioni e la conclusione al livello di ascolto previsto. Segna la sezione funzionale al montaggio e conserva la traccia completa per eventuali modifiche successive. Un estratto musicale adatto si valuta nel contesto della voce, delle immagini e del ritmo del prodotto completato.
Conserva insieme l'idea scritta, l'impostazione dell'opzione strumentale, la selezione del modello e tutte le tracce completate. Quando una proposta richiede una revisione, identifica la discrepanza musicale, come un arrangiamento troppo denso sotto il parlato o un'apertura che si sviluppa troppo lentamente. Mantieni la direzione utile e modifica la parte del brief collegata al problema.
POST /v1/music/generationstextaudio, image, video| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti suno-api Condizioni: Usa esattamente questo selettore di instradamento di Ailoot. | Predefinito— |
Campogpt_description_prompt | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: Descrivi l’idea musicale o il tema della canzone. | Predefinito— |
Campomv | Tipostring | RequisitoObbligatorio | Valori e limiti chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Condizioni: Seleziona esplicitamente una versione documentata di Suno; l’esempio usa chirp-crow (v5). | Predefinito— |
Campomake_instrumental | Tipoboolean | RequisitoObbligatorio | Valori e limiti Condizioni: Imposta true per la musica strumentale o false per una canzone. | Predefinito— |
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, gpt_description_prompt, mv, make_instrumental |
Parametrooptional | Contratto |
Parametromaterial_types | Contrattotext |
Parametroconditions | ContrattoUsa esattamente questo selettore di instradamento di Ailoot., Descrivi l’idea musicale o il tema della canzone., Seleziona esplicitamente una versione documentata di Suno; l’esempio usa chirp-crow (v5)., Imposta true per la musica strumentale o false per una canzone. |
Ciclo di vita: submit_once_poll_original
GET /v1/music/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Quantità fatturata | Costo |
|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Quantità fatturata— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePer richiesta | Listino delle tariffe— | Quantità prevista— | Quantità fatturatauna richiesta | Costo Input · Stima solo a fini di confronto $0.2 per richiesta |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Quantità fatturata— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.2 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
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}"\ncat > request.json <<'JSON'\n{\n "model": "suno-api",\n "gpt_description_prompt": "古诗词",\n "mv": "chirp-crow",\n "make_instrumental": false\n}\nJSON\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\n# Create once; retain id, polling_url, original task identifiers and every header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nScarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/music/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}Conserva ogni risposta, file e parte di contenuto restituiti per intero.
Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.
Conserva l'id pubblico dell'attività o dell'operazione restituito e tutte le intestazioni. Consulta solo l'attività originale; unknown o result_pending_check non autorizza un'altra creazione.
| Campo | Tipo |
|---|---|
Campoid | Tipostring |
Campopolling_url | Tipostring |
Campoprovider_task_id | Tipostring |
Campodata.task_id | Tipostring |
Campodata.status | Tipostring |
Campodata.data[].audio_url | Tipostring |
Campodata.data[].image_url | Tipostring |
Campodata.data[].image_large_url | Tipostring |
Campodata.data[].video_url | Tipostring |
Ailoot Ultra suno-api
Usa i percorsi dei metodi indicati sopra.